gitea-cli-skill 0.1.7 → 0.1.9

package/assets/REFERENCE.md

@@ -0,0 +1,273 @@
+# gitea-cli Reference
+
+Full command reference and workflow details. This file is loaded on demand — the core rules and binary location are in SKILL.md.
+
+## Workflow: Issue 处理
+
+```bash
+# 1. 查看 open issues
+gitea-cli issue list --state open --output json
+
+# 2. 查看 issue 详情
+gitea-cli issue get <number> --output json
+
+# 3. 查找 label/milestone ID
+gitea-cli label list --output json
+gitea-cli milestone list --output json
+
+# 4. 更新 issue
+gitea-cli issue update <number> --label <id> --milestone <id>
+
+# 5. 添加评论
+gitea-cli issue comment create <number> -b "分析原因：..."
+
+# 6. 上传附件（图片自动嵌入为 markdown）
+gitea-cli issue attachment upload <number> ./screenshot.png
+
+# 7. 关闭 issue
+gitea-cli issue close <number>
+```
+
+## Workflow: PR 工作流
+
+```bash
+# 1. 创建 feature 分支
+gitea-cli branch create feature/xyz --from main
+
+# 2. 创建 PR
+gitea-cli pr create --title "feat: xxx" --head feature/xyz --base main --body "## Summary\n- Changes"
+
+# 3. 查看 PR 状态
+gitea-cli pr get <index> --output json
+
+# 4. 检查 CI
+gitea-cli actions run list --output json
+gitea-cli actions run jobs <run-id> --output json
+
+# 5. 合并 PR
+gitea-cli pr merge <index> --strategy squash --delete-branch
+```
+
+## Workflow: Release 发布
+
+```bash
+# 1. 查看最近提交
+gitea-cli commit list --branch main --limit 20 --output json
+
+# 2. 查看 tags/releases
+gitea-cli tag list --output json
+gitea-cli release list --output json
+
+# 3. 创建 tag + release
+gitea-cli tag create v1.0.0 --target main -m "Release v1.0.0"
+gitea-cli release create --tag v1.0.0 --name "v1.0.0" --body "## Changes\n- ..." --target main
+
+# 4. 上传 assets
+gitea-cli release asset upload v1.0.0 ./dist/binary --name binary-linux-amd64
+
+# 5. 确认
+gitea-cli release get v1.0.0 --output json
+gitea-cli release asset list v1.0.0 --output json
+```
+
+## Workflow: CI/CD 排障
+
+```bash
+gitea-cli actions run list --limit 10 --output json
+gitea-cli actions run jobs <run-id> --output json
+gitea-cli actions job logs <job-id> -o ./logs/
+gitea-cli actions job get <job-id> --output json
+gitea-cli actions workflow dispatch <workflow-id> --ref main
+gitea-cli actions artifact list --output json
+gitea-cli actions artifact download <artifact-id> -o ./dist/
+```
+
+## Workflow: 仓库文件修改
+
+```bash
+# 读取
+gitea-cli content get src/config.yaml --output json
+
+# 创建新文件
+gitea-cli content create src/config.yaml --content "new: value" -m "add config"
+
+# 更新（SHA 自动获取）
+gitea-cli content update src/config.yaml --content "updated: value" -m "update config"
+
+# 从本地文件上传
+gitea-cli content update src/config.yaml --file ./local-config.yaml -m "update from local"
+```
+
+## Workflow: 配置管理
+
+```bash
+gitea-cli config list --output json
+gitea-cli config set --name work --host <url> --token <tok> --default-owner myorg
+gitea-cli config get work
+# 临时使用其他 context
+gitea-cli issue list --context personal --output json
+```
+
+## Command Reference
+
+### Config
+
+```bash
+gitea-cli config list                                        # List all contexts
+gitea-cli config get <name>                                  # Get context details
+gitea-cli config set --name <ctx> --host <url> --token <tok> # Create/update context
+# Additional flags: --default-owner, --default-repo
+```
+
+### Repository
+
+```bash
+gitea-cli repo list --owner <org> --output json
+gitea-cli repo get --owner <org> --repo <repo> --output json
+```
+
+### Branch
+
+```bash
+gitea-cli branch list --output json
+gitea-cli branch get <name> --output json
+gitea-cli branch create <name> --from <base>
+gitea-cli branch delete <name> --force
+gitea-cli branch protect list --output json
+gitea-cli branch protect create <name> --enable-push --required-approvals 2
+gitea-cli branch protect delete <name> --force
+```
+
+### File Content
+
+```bash
+gitea-cli content list [--path] --ref <branch> --output json
+gitea-cli content get <path> --ref <branch> --output json       # --raw for decoded content
+gitea-cli content create <path> --content "text" -m "msg"       # or --file <local>
+gitea-cli content update <path> --content "text" -m "msg"       # --sha auto-fetched
+gitea-cli content delete <path> -m "msg" --force
+```
+
+### Commit
+
+```bash
+gitea-cli commit list --branch <ref> --limit 10 --output json
+gitea-cli commit get <sha> --output json
+```
+
+### Issue
+
+```bash
+gitea-cli issue list --state open --output json
+gitea-cli issue get <number> --output json
+gitea-cli issue create -t "Title" -b "Body" --label <id> --milestone <id>
+gitea-cli issue create -t "Title" --attach ./image.png --attach ./log.txt
+gitea-cli issue update <number> -t "New Title" --state closed
+gitea-cli issue close <number>
+
+# Comments
+gitea-cli issue comment list <number> --output json
+gitea-cli issue comment create <number> -b "Comment text"
+gitea-cli issue comment update <comment-id> -b "Updated text"
+gitea-cli issue comment delete <comment-id> --force
+
+# Attachments
+gitea-cli issue attachment list <number> --output json
+gitea-cli issue attachment upload <number> <file> --name <filename>
+gitea-cli issue attachment download <number> <attach-id> -o ./save/
+gitea-cli issue attachment delete <number> <attach-id> --force
+```
+
+### Pull Request
+
+```bash
+gitea-cli pr list --state open --output json
+gitea-cli pr get <index> --output json
+gitea-cli pr create --title "Title" --head <src> --base <target> --body "Desc"
+gitea-cli pr close <index>
+gitea-cli pr reopen <index>
+gitea-cli pr merge <index> --strategy merge --delete-branch
+# Strategies: merge, rebase, squash, fast-forward-only
+```
+
+### Label
+
+```bash
+gitea-cli label list --output json
+gitea-cli label get <id> --output json
+gitea-cli label create --name "bug" --color "#ff0000" --description "Bug report"
+gitea-cli label delete <id> --force
+```
+
+### Milestone
+
+```bash
+gitea-cli milestone list --state open --output json
+gitea-cli milestone get <id> --output json
+gitea-cli milestone create --title "v1.0" --description "First release" --due-on 2025-12-31T00:00:00Z
+gitea-cli milestone close <id>
+gitea-cli milestone delete <id> --force
+```
+
+### Tag
+
+```bash
+gitea-cli tag list --output json
+gitea-cli tag get <name> --output json
+gitea-cli tag create <name> --target <ref> -m "Annotated tag message"
+gitea-cli tag delete <name> --force
+```
+
+### Actions (CI/CD)
+
+```bash
+# Workflows
+gitea-cli actions workflow list --output json
+gitea-cli actions workflow get <id-or-filename> --output json
+gitea-cli actions workflow enable <id-or-filename>
+gitea-cli actions workflow disable <id-or-filename>
+gitea-cli actions workflow dispatch <id-or-filename> --ref main --input key=value
+
+# Runs
+gitea-cli actions run list --status completed --output json
+gitea-cli actions run get <run-id> --output json
+gitea-cli actions run jobs <run-id> --output json
+gitea-cli actions run artifacts <run-id> --output json
+gitea-cli actions run delete <run-id> --force
+
+# Jobs
+gitea-cli actions job get <job-id> --output json
+gitea-cli actions job logs <job-id> -o ./logs/
+
+# Artifacts
+gitea-cli actions artifact list --output json
+gitea-cli actions artifact download <id> -o ./dist/
+gitea-cli actions artifact delete <id> --force
+```
+
+### Webhook
+
+```bash
+gitea-cli webhook list --output json
+gitea-cli webhook get <id> --output json
+gitea-cli webhook create --url <endpoint> --secret <secret> --event push --event issues --active
+gitea-cli webhook update <id> --url <new-url> --active false
+gitea-cli webhook delete <id> --force
+gitea-cli webhook test <id>
+```
+
+### Release
+
+```bash
+gitea-cli release list --output json
+gitea-cli release get <tag> --output json
+gitea-cli release create --tag <tag> --name "Title" --body "Notes" --target <ref> --draft --prerelease
+gitea-cli release create --tag <tag> --body-file changelog.md            # avoids encoding issues
+gitea-cli release delete <tag> --force
+
+# Assets
+gitea-cli release asset list <tag> --output json
+gitea-cli release asset upload <tag> <file> --name <asset-name>
+gitea-cli release asset download <tag> <asset-id> -o ./downloads/
+gitea-cli release asset delete <tag> <asset-id> --force
+```

package/assets/SKILL.md

@@ -5,307 +5,86 @@ description: Use when needing to interact with Gitea repositories, branches, iss
 
 # gitea-cli
 
-## Binary Location
-
-Binaries for all platforms are bundled under the `scripts/` directory relative to this skill:
+Stateless CLI for Gitea HTTP API. Every call is an independent request, safe for concurrent use.
 
-| Platform | Relative Path |
-|----------|------|
-| Linux amd64 | `scripts/linux-amd64/gitea-cli` |
-| Linux arm64 | `scripts/linux-arm64/gitea-cli` |
-| macOS amd64 | `scripts/darwin-amd64/gitea-cli` |
-| macOS arm64 | `scripts/darwin-arm64/gitea-cli` |
-| Windows amd64 | `scripts/windows-amd64/gitea-cli.exe` |
-| Windows arm64 | `scripts/windows-arm64/gitea-cli.exe` |
+## Binary Location
 
-**Skill directory is `~/.claude/skills/gitea-cli/`.** Before executing commands, resolve `gitea-cli` to the platform-appropriate binary. Auto-detect with:
+Resolve `gitea-cli` to the platform binary in skill directory `~/.claude/skills/gitea-cli/`:
 
 ```bash
-SKILL_DIR="$HOME/.claude/skills/gitea-cli"
-
 # Linux / macOS
+SKILL_DIR="$HOME/.claude/skills/gitea-cli"
 OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
-ARCH="$(uname -m)"
-[[ "$ARCH" == "x86_64" ]] && ARCH="amd64"
-[[ "$ARCH" == "aarch64" || "$ARCH" == "arm64" ]] && ARCH="arm64"
+ARCH="$(uname -m)" && [[ "$ARCH" == "x86_64" ]] && ARCH="amd64" && [[ "$ARCH" == "aarch64" || "$ARCH" == "arm64" ]] && ARCH="arm64"
 GITEA_CLI="$SKILL_DIR/scripts/${OS}-${ARCH}/gitea-cli"
-
-# Windows (PowerShell)
-# $GITEA_CLI = "$env:USERPROFILE\.claude\skills\gitea-cli\scripts\windows-amd64\gitea-cli.exe"
+# Windows: %USERPROFILE%\.claude\skills\gitea-cli\scripts\windows-amd64\gitea-cli.exe
 ```
 
-If the tool is also available in PATH (e.g. installed globally), `gitea-cli` can be used directly.
-
-## Overview
-
-`gitea-cli` is a stateless CLI tool that manages Gitea repositories through the HTTP API. Each call is an independent API request, making it safe for concurrent use. It supports both human-friendly table output and machine-friendly JSON output (`--output json`).
+If available in PATH, `gitea-cli` can be used directly.
 
 ## Agent Rules
 
-### 1. Always use JSON output
-
-```bash
-gitea-cli <command> --output json --owner <owner> --repo <repo>
-```
-
-### 2. Never switch context autonomously
-
-Use `--owner`/`--repo` flags to target different repos. Do NOT call `config use` without user supervision.
-
-### 3. Destructive operations require confirmation
-
-Always run a list/get command first to verify the target exists before deleting.
-
-### 4. Branch/ref auto-detection
-
-When inside a git repo, `--branch` and `--ref` default to the current branch. `--owner`/`--repo` auto-detect from git remote.
+1. **Always `--output json`** — All calls must include this flag
+2. **Never switch context** — Use `--owner`/`--repo` flags; do NOT call `config use` autonomously
+3. **Verify before delete** — Run `list`/`get` first, then `--force` for non-interactive
+4. **Auto-detection** — In a git repo, `--branch`/`--ref`/`--owner`/`--repo` auto-detect from `.git`
 
 ## Global Flags
 
 | Flag | Short | Description |
 |------|-------|-------------|
-| `--output` | `-o` | `json` or `table` (agents: always use `json`) |
-| `--owner` | | Repository owner |
-| `--repo` | `-r` | Repository name |
+| `--output` | `-o` | `json` (agents: always) or `table` |
+| `--owner` | | Repository owner (auto-detect from git) |
+| `--repo` | `-r` | Repository name (auto-detect from git) |
 | `--context` | `-c` | Context name (override, no save) |
-| `--config` | | Config file path |
 | `--host` | | Gitea host URL |
 | `--token` | | API token |
 
-**Env vars:** `GITEA_HOST`, `GITEA_TOKEN`, `GITEA_OWNER`, `GITEA_REPO`, `GITEA_OUTPUT`
-
-## Command Quick Reference
-
-### Config
-
-```bash
-gitea-cli config list                                        # List all contexts
-gitea-cli config get <name>                                  # Get context details
-gitea-cli config set --name <ctx> --host <url> --token <tok> # Create/update context
-```
-
-### Repository
-
-```bash
-gitea-cli repo list --owner <org> --output json
-gitea-cli repo get --owner <org> --repo <repo> --output json
-```
-
-### Branch
-
-```bash
-gitea-cli branch list --output json
-gitea-cli branch get <name> --output json
-gitea-cli branch create <name> --from <base>
-gitea-cli branch delete <name> --force
-gitea-cli branch protect list --output json
-gitea-cli branch protect create <name> --enable-push --required-approvals 2
-gitea-cli branch protect delete <name> --force
-```
-
-### File Content
-
-```bash
-gitea-cli content list [--path] --ref <branch> --output json
-gitea-cli content get <path> --ref <branch> --output json       # --raw for decoded content in json
-gitea-cli content create <path> --content "text" -m "msg"       # or --file <local>
-gitea-cli content update <path> --content "text" -m "msg"       # --sha auto-fetched
-gitea-cli content delete <path> -m "msg" --force
-```
-
-### Commit
-
-```bash
-gitea-cli commit list --branch <ref> --limit 10 --output json
-gitea-cli commit get <sha> --output json
-```
-
-### Issue
-
-```bash
-gitea-cli issue list --state open --output json
-gitea-cli issue get <number> --output json
-gitea-cli issue create -t "Title" -b "Body" --label <id> --milestone <id>
-gitea-cli issue create -t "Title" --attach ./image.png --attach ./log.txt   # embed attachments in body
-gitea-cli issue update <number> -t "New Title" --state closed
-gitea-cli issue close <number>
-
-# Comments
-gitea-cli issue comment list <number> --output json
-gitea-cli issue comment create <number> -b "Comment text"
-gitea-cli issue comment update <comment-id> -b "Updated text"
-gitea-cli issue comment delete <comment-id> --force
-
-# Attachments
-gitea-cli issue attachment list <number> --output json
-gitea-cli issue attachment upload <number> <file> --name <filename>
-gitea-cli issue attachment download <number> <attach-id> -o ./save/
-gitea-cli issue attachment delete <number> <attach-id> --force
-```
-
-### Pull Request
-
-```bash
-gitea-cli pr list --state open --output json
-gitea-cli pr get <index> --output json
-gitea-cli pr create --title "Title" --head <src> --base <target> --body "Desc"
-gitea-cli pr close <index>
-gitea-cli pr reopen <index>
-gitea-cli pr merge <index> --strategy merge --delete-branch
-```
-
-### Label
-
-```bash
-gitea-cli label list --output json
-gitea-cli label get <id> --output json
-gitea-cli label create --name "bug" --color "#ff0000" --description "Bug report"
-gitea-cli label delete <id> --force
-```
-
-### Milestone
-
-```bash
-gitea-cli milestone list --state open --output json
-gitea-cli milestone get <id> --output json
-gitea-cli milestone create --title "v1.0" --description "First release" --due-on 2025-12-31T00:00:00Z
-gitea-cli milestone close <id>
-gitea-cli milestone delete <id> --force
-```
-
-### Tag
-
-```bash
-gitea-cli tag list --output json
-gitea-cli tag get <name> --output json
-gitea-cli tag create <name> --target <ref> -m "Annotated tag message"
-gitea-cli tag delete <name> --force
-```
-
-### Actions (CI/CD)
-
-```bash
-# Workflows
-gitea-cli actions workflow list --output json
-gitea-cli actions workflow get <id-or-filename> --output json
-gitea-cli actions workflow enable <id-or-filename>
-gitea-cli actions workflow disable <id-or-filename>
-gitea-cli actions workflow dispatch <id-or-filename> --ref main --input key=value
-
-# Runs
-gitea-cli actions run list --status completed --output json
-gitea-cli actions run get <run-id> --output json
-gitea-cli actions run jobs <run-id> --output json
-gitea-cli actions run artifacts <run-id> --output json
-gitea-cli actions run delete <run-id> --force
+Env vars: `GITEA_HOST`, `GITEA_TOKEN`, `GITEA_OWNER`, `GITEA_REPO`
 
-# Jobs
-gitea-cli actions job get <job-id> --output json
-gitea-cli actions job logs <job-id> -o ./logs/
+## Command Summary
 
-# Artifacts
-gitea-cli actions artifact list --output json
-gitea-cli actions artifact download <id> -o ./dist/
-gitea-cli actions artifact delete <id> --force
 ```
-
-### Webhook
-
-```bash
-gitea-cli webhook list --output json
-gitea-cli webhook get <id> --output json
-gitea-cli webhook create --url <endpoint> --secret <secret> --event push --event issues --active
-gitea-cli webhook update <id> --url <new-url> --active false
-gitea-cli webhook delete <id> --force
-gitea-cli webhook test <id>
+config set/list/get/use          — Context configuration
+issue list/get/create/update/close — Issues + comments + attachments
+pr list/get/create/close/reopen/merge — Pull requests
+branch list/get/create/delete     — Branches + protection rules
+content list/get/create/update/delete — Repo file CRUD
+commit list/get                   — Commit history
+label list/get/create/delete      — Labels
+milestone list/get/create/close/delete — Milestones
+tag list/get/create/delete        — Tags
+release list/get/create/delete    — Releases + assets
+actions workflow/run/job/artifact — CI/CD management
+webhook list/get/create/update/delete/test — Webhooks
 ```
 
-### Release
+## Common Workflows
 
-```bash
-gitea-cli release list --output json
-gitea-cli release get <tag> --output json
-gitea-cli release create --tag <tag> --name "Title" --body "Notes" --target <ref> --draft --prerelease
-gitea-cli release create --tag <tag> --body-file changelog.md            # use file for release notes (avoids encoding issues)
-gitea-cli release delete <tag> --force
-
-# Assets
-gitea-cli release asset list <tag> --output json
-gitea-cli release asset upload <tag> <file> --name <asset-name>
-gitea-cli release asset download <tag> <asset-id> -o ./downloads/
-gitea-cli release asset delete <tag> <asset-id> --force
-```
+When performing a task, follow the matching workflow. Read `REFERENCE.md` in the same skill directory for full command details and flags.
 
-## Common Patterns
+**Issue** — `issue list` → `issue get <n>` → `comment create <n>` → `issue close <n>`
+**PR** — `branch create <name> --from <base>` → `pr create` → `actions run list` → `pr merge <idx>`
+**Release** — `tag create <v>` → `release create --tag <v>` → `release asset upload <v> <file>`
+**CI/CD** — `actions run list` → `actions run jobs <run>` → `actions job logs <job>`
+**File edit** — `content get <path>` → `content update <path> --content "..." -m "msg"`
+**Config** — `config set --name <ctx> --host <url> --token <tok>`
 
-### Read file from repo, modify, write back
-
-```bash
-# 1. Get current content (captures SHA for update)
-gitea-cli content get src/config.yaml --output json --owner myorg --repo myrepo
+## Error Handling
 
-# 2. Update with new content (SHA auto-fetched if omitted)
-gitea-cli content update src/config.yaml --content "new: value" -m "update config" --owner myorg --repo myrepo
-```
+| Error | Fix |
+|-------|-----|
+| `host is required` | Run `config set` |
+| `API 404` | Verify owner/repo/index |
+| `API 409` | Already exists, skip |
+| `API 401` | Check token |
 
-### Create issue with labels and milestone
+Destructive ops: always `list`/`get` first, then `--force`. Deleted resources cannot be recovered.
 
-```bash
-# 1. Find label IDs
-gitea-cli label list --output json --owner myorg --repo myrepo
+## On-Demand Reference
 
-# 2. Find milestone ID
-gitea-cli milestone list --output json --owner myorg --repo myrepo
+For full command flags and detailed workflow steps, read the reference file:
 
-# 3. Create issue
-gitea-cli issue create -t "Fix login bug" -b "Description" --label 3 --label 7 --milestone 2 --owner myorg --repo myrepo
 ```
-
-### Create issue with attachments
-
-```bash
-# Attach images (auto-embedded as markdown images) and files (embedded as links)
-gitea-cli issue create -t "Bug screenshot" -b "Steps to reproduce..." \
-  --attach ./screenshot.png --attach ./error.log --owner myorg --repo myrepo
-
-# Supported image formats: png, jpg, jpeg, gif, webp, bmp, svg
-# Other file types are embedded as download links
+~/.claude/skills/gitea-cli/REFERENCE.md
 ```
-
-### Monitor CI/CD pipeline
-
-```bash
-# 1. Find latest run
-gitea-cli actions run list --limit 5 --output json
-
-# 2. Check job status
-gitea-cli actions run jobs <run-id> --output json
-
-# 3. Get logs for failed job
-gitea-cli actions job logs <job-id> -o ./logs/
-```
-
-## Error Handling
-
-| Exit Code | Meaning |
-|-----------|---------|
-| `0` | Success |
-| `1` | Error (see stderr) |
-
-JSON errors on stderr: `{"error": "API 404: repository not found"}`
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `host is required` | No context configured | Run `config set` |
-| `API 404` | Resource not found | Verify owner/repo/index |
-| `API 409` | Resource already exists | Skip duplicate creation |
-| `API 401` | Invalid/expired token | Check context token |
-
-## Destructive Operations Checklist
-
-Before running any delete, always verify:
-
-1. Run the corresponding `list` or `get` command first
-2. Confirm the resource ID/name matches the intended target
-3. Use `--force` flag to skip interactive prompts (required for agent use)
-4. Consider irreversibility — deleted resources cannot be recovered

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitea-cli-skill",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Install gitea-cli as a Claude Code skill",
   "bin": {
     "gitea-cli-skill": "src/index.js"

package/src/index.js

@@ -65,6 +65,15 @@ function resolveSkillDir(platformName, targetPath) {
   return path.join(os.homedir(), PLATFORMS.claude.dir, SKILL_NAME);
 }
 
+// ── Find gitea-cli binary for the given platform ────────────────────────────
+
+function findGiteaCliBin(platformName, targetPath) {
+  const osArch = detectOSArch();
+  const binaryName = osArch.os === 'windows' ? 'gitea-cli.exe' : 'gitea-cli';
+  const skillDir = resolveSkillDir(platformName, targetPath);
+  return path.join(skillDir, 'scripts', `${osArch.os}-${osArch.arch}`, binaryName);
+}
+
 // ── HTTP via curl (robust cross-platform) ───────────────────────────────────
 
 function curlGet(url, token) {
@@ -132,39 +141,27 @@ function extractArchive(archivePath, destDir, osArch) {
   throw new Error(`Binary ${binaryName} not found in extracted archive`);
 }
 
-// ── Config generation ───────────────────────────────────────────────────────
+// ── Config via gitea-cli ────────────────────────────────────────────────────
 
-function writeGiteaCliConfig(host, token) {
-  const configDir = path.join(os.homedir(), '.config', 'gitea-cli');
-  const configPath = path.join(configDir, 'config.yaml');
-  const contextName = 'default';
-
-  // Read existing config if present
-  let existing = '';
-  if (fs.existsSync(configPath)) {
-    existing = fs.readFileSync(configPath, 'utf-8');
-    if (existing.includes(contextName)) {
-      console.log(`  Config already exists: ${configPath} (skipped)`);
-      return;
-    }
-  }
-
-  const newConfig = `${existing}contexts:
-- name: ${contextName}
-  host: ${host.replace(/\/$/, '')}
-  token: ${token}
-current-context: ${contextName}
-`;
+function configureContext({ giteaCliBin, host, token, contextName, defaultOwner, defaultRepo }) {
+  const ctxName = contextName || 'default';
+  const cmdArgs = [
+    `"${giteaCliBin}"`,
+    'config', 'set',
+    '--name', ctxName,
+    '--host', host.replace(/\/$/, ''),
+    '--token', token,
+  ];
+  if (defaultOwner) cmdArgs.push('--default-owner', defaultOwner);
+  if (defaultRepo) cmdArgs.push('--default-repo', defaultRepo);
 
-  fs.mkdirSync(configDir, { recursive: true });
-  fs.writeFileSync(configPath, newConfig, 'utf-8');
-  console.log(`  Config -> ${configPath}`);
+  execSync(cmdArgs.join(' '), { stdio: 'inherit', timeout: 10000 });
 }
 
 // ── Install command ─────────────────────────────────────────────────────────
 
 async function install(args) {
-  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, local: localDir, force } = args;
+  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, local: localDir, force, name: contextName, 'default-owner': defaultOwner, 'default-repo': defaultRepo } = args;
   const giteaHost = explicitHost || GITEA_HOST;
   const token = explicitToken || process.env.GITEA_TOKEN || null;
   const osArch = detectOSArch();
@@ -188,15 +185,26 @@ async function install(args) {
     console.log(`  Binary already exists: ${destBinary} (use --force to overwrite)`);
   } else if (localDir) {
     // --local: copy from local directory
-    await installFromLocal(localDir, scriptsDir, destBinary, osArch);
+    installFromLocal(localDir, scriptsDir, destBinary, osArch);
   } else {
     // Download from Gitea releases
     await installFromRelease(giteaHost, token, scriptsDir, destBinary, osArch);
   }
 
-  // 4. Write gitea-cli config if token provided
+  // 3. Configure context if token provided
   if (token) {
-    writeGiteaCliConfig(giteaHost, token);
+    const giteaCliBin = findGiteaCliBin(platformName, targetPath);
+    if (fs.existsSync(giteaCliBin)) {
+      console.log('  Configuring context...');
+      try {
+        configureContext({ giteaCliBin, host: giteaHost, token, contextName, defaultOwner, defaultRepo });
+      } catch (err) {
+        console.error(`  Failed to configure context: ${err.message}`);
+        console.error('  You can manually run: gitea-cli config set --name default --host <url> --token <token>');
+      }
+    } else {
+      console.log('  Binary not found for context setup, skipping.');
+    }
   }
 
   console.log(`\nDone!`);
@@ -207,7 +215,6 @@ async function install(args) {
 function installFromLocal(localDir, scriptsDir, destBinary, osArch) {
   // Goreleaser dist structure: dist/gitea-cli_<version>_<os>_<arch>/gitea-cli[.exe]
   const ext = osArch.os === 'windows' ? 'zip' : 'tar.gz';
-  const archiveName = `gitea-cli_*_${osArch.os}_${osArch.arch}.${ext}`;
 
   const resolvedDir = localDir.replace(/^~/, os.homedir());
 
@@ -294,7 +301,7 @@ async function installFromRelease(giteaHost, token, scriptsDir, destBinary, osAr
 // ── Context command ─────────────────────────────────────────────────────────
 
 async function addContext(args) {
-  const { token: explicitToken, host: explicitHost, 'default-owner': defaultOwner, 'default-repo': defaultRepo, name: contextName } = args;
+  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, 'default-owner': defaultOwner, 'default-repo': defaultRepo, name: contextName } = args;
   const host = explicitHost || GITEA_HOST;
   const token = explicitToken || process.env.GITEA_TOKEN || null;
 
@@ -307,40 +314,14 @@ async function addContext(args) {
     process.exit(1);
   }
 
-  // Find the installed gitea-cli binary
-  const osArch = detectOSArch();
-  const binaryName = osArch.os === 'windows' ? 'gitea-cli.exe' : 'gitea-cli';
-  const skillDir = path.join(os.homedir(), PLATFORMS.claude.dir, SKILL_NAME);
-  const giteaCliBin = path.join(skillDir, 'scripts', `${osArch.os}-${osArch.arch}`, binaryName);
+  const giteaCliBin = findGiteaCliBin(platformName, targetPath);
 
   if (!fs.existsSync(giteaCliBin)) {
-    // Fallback: write config manually
-    console.log('  gitea-cli binary not found, writing config directly...');
-    writeGiteaCliConfig(host, token);
-    console.log('Context configured successfully.');
-    return;
-  }
-
-  // Use gitea-cli config set for proper config management
-  const ctxName = contextName || 'default';
-  const cmdArgs = [
-    `"${giteaCliBin}"`,
-    'config', 'set',
-    '--name', ctxName,
-    '--host', host.replace(/\/$/, ''),
-    '--token', token,
-  ];
-  if (defaultOwner) cmdArgs.push('--default-owner', defaultOwner);
-  if (defaultRepo) cmdArgs.push('--default-repo', defaultRepo);
-
-  try {
-    execSync(cmdArgs.join(' '), { stdio: 'inherit', timeout: 10000 });
-  } catch (err) {
-    console.error(`Failed to configure context: ${err.message}`);
-    console.error('You can manually run:');
-    console.error(`  ${cmdArgs.join(' ')}`);
+    console.error('Error: gitea-cli binary not found. Run `npx gitea-cli-skill init` first.');
     process.exit(1);
   }
+
+  configureContext({ giteaCliBin, host, token, contextName, defaultOwner, defaultRepo });
 }
 
 // ── CLI ──────────────────────────────────────────────────────────────────────
@@ -374,49 +355,56 @@ function printHelp() {
   console.log(`gitea-cli-skill - Install gitea-cli as an AI agent skill
 
 Usage:
-  npx gitea-cli-skill init [flags]                          # Install skill
-  gitea-cli-skill add context [flags]                       # Configure Gitea API context
+  npx gitea-cli-skill init [flags]                          # Install + configure
+  gitea-cli-skill add context [flags]                       # Update context only
 
 Commands:
-  init                    Install skill (download binary + SKILL.md)
+  init                    Install skill (binary + SKILL.md) and optionally configure context
   add context             Add or update a Gitea API context (requires --token)
 
 Flags (init):
-  --token <t>       Gitea API token (needed for private repos, or set GITEA_TOKEN env var)
-  --host <url>      Gitea host URL (default: ${GITEA_HOST})
-  --local <dir>     Install from local goreleaser dist directory (skip download)
-  --platform <name> Target AI platform (default: claude)
-  --target <path>   Custom install directory (overrides --platform)
-  --force           Overwrite existing binary
+  --token <t>              Gitea API token (needed for private repos, enables auto-config)
+  --host <url>             Gitea host URL (default: ${GITEA_HOST})
+  --local <dir>            Install from local goreleaser dist directory (skip download)
+  --platform <name>        Target AI platform (default: claude)
+  --target <path>          Custom install directory (overrides --platform)
+  --name <name>            Context name for auto-config (default: "default")
+  --default-owner <owner>  Default owner for auto-config (optional)
+  --default-repo <repo>    Default repo for auto-config (optional)
+  --force                  Overwrite existing binary
 
 Flags (add context):
-  --name <name>           Context name (default: "default")
-  --host <url>            Gitea host URL (required)
-  --token <t>             Gitea API token (required, or set GITEA_TOKEN env var)
-  --default-owner <owner> Default repository owner (optional)
-  --default-repo <repo>   Default repository name (optional)
+  --name <name>            Context name (default: "default")
+  --host <url>             Gitea host URL (required)
+  --token <t>              Gitea API token (required, or set GITEA_TOKEN env var)
+  --default-owner <owner>  Default repository owner (optional)
+  --default-repo <repo>    Default repository name (optional)
+  --platform <name>        AI platform to locate binary (default: claude)
 
 Global:
-  -h, --help        Show this help
+  -h, --help               Show this help
 
 Platforms:
 ${platformList}
 
 Examples:
-  # Step 1: Install the skill (no token needed for public repos)
-  npx gitea-cli-skill init
+  # One-step install + configure (recommended)
+  npx gitea-cli-skill init --host https://gitea.example.com --token abc123
 
-  # Step 2: Configure context
-  gitea-cli-skill add context --host https://gitea.example.com --token abc123
+  # With default owner
+  npx gitea-cli-skill init --host https://gitea.example.com --token abc123 --default-owner myorg
 
-  # Configure context with all options
-  gitea-cli-skill add context --name work --host https://gitea.example.com --token abc123 --default-owner myorg
+  # Install only (public repo, no token needed)
+  npx gitea-cli-skill init
 
-  # Or install + configure in one step (for private repos)
-  npx gitea-cli-skill init --token abc123
+  # Update context later
+  gitea-cli-skill add context --host https://gitea.example.com --token new-token
 
-  # Or install from local build
+  # Install from local build
   npx gitea-cli-skill init --local ../dist
+
+  # Install for another AI platform
+  npx gitea-cli-skill init --platform cursor --host https://gitea.example.com --token abc123
 `);
 }