gitea-cli-skill 0.1.0 → 0.1.7

package/assets/SKILL.md

@@ -126,6 +126,7 @@ gitea-cli commit get <sha> --output json
 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>
 
@@ -225,6 +226,7 @@ gitea-cli webhook test <id>
 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
@@ -259,6 +261,17 @@ gitea-cli milestone list --output json --owner myorg --repo myrepo
 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
+```
+
 ### Monitor CI/CD pipeline
 
 ```bash

package/package.json

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

package/src/index.js

@@ -251,19 +251,19 @@ function installFromLocal(localDir, scriptsDir, destBinary, osArch) {
 
 async function installFromRelease(giteaHost, token, scriptsDir, destBinary, osArch) {
   console.log(`  Fetching latest release from ${giteaHost}...`);
-  if (!token) {
-    console.error('  Error: Gitea API token is required.');
-    console.error('  Provide via --token <token> or GITEA_TOKEN env var.');
-    console.error('  Or use --local <dir> to install from a local build.');
-    process.exit(1);
-  }
 
   let release;
   try {
     release = getLatestRelease(giteaHost, GITEA_OWNER, GITEA_REPO, token);
   } catch (err) {
-    console.error(`  Failed to fetch release: ${err.message}`);
-    console.error('  Use --local <dir> to install from a local build instead.');
+    if (!token) {
+      console.error(`  Failed to fetch release without token: ${err.message}`);
+      console.error('  Repository may be private. Provide --token or GITEA_TOKEN env var.');
+      console.error('  Or use --local <dir> to install from a local build.');
+    } else {
+      console.error(`  Failed to fetch release: ${err.message}`);
+      console.error('  Use --local <dir> to install from a local build instead.');
+    }
     process.exit(1);
   }
 
@@ -291,10 +291,62 @@ 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 host = explicitHost || GITEA_HOST;
+  const token = explicitToken || process.env.GITEA_TOKEN || null;
+
+  if (!token) {
+    console.error('Error: --token or GITEA_TOKEN env var is required for context setup.');
+    process.exit(1);
+  }
+  if (!host) {
+    console.error('Error: --host is required for context setup.');
+    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);
+
+  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(' ')}`);
+    process.exit(1);
+  }
+}
+
 // ── CLI ──────────────────────────────────────────────────────────────────────
 
 function parseArgs(argv) {
-  const args = { token: null, host: null, platform: null, target: null, local: null, force: false, command: null };
+  const args = { token: null, host: null, platform: null, target: null, local: null, force: false, command: null, subcommand: null, name: null, 'default-owner': null, 'default-repo': null };
 
   for (let i = 2; i < argv.length; i++) {
     const arg = argv[i];
@@ -303,9 +355,13 @@ function parseArgs(argv) {
     else if (arg === '--platform' && i + 1 < argv.length) args.platform = argv[++i];
     else if (arg === '--target' && i + 1 < argv.length) args.target = argv[++i];
     else if (arg === '--local' && i + 1 < argv.length) args.local = argv[++i];
+    else if (arg === '--name' && i + 1 < argv.length) args.name = argv[++i];
+    else if (arg === '--default-owner' && i + 1 < argv.length) args['default-owner'] = argv[++i];
+    else if (arg === '--default-repo' && i + 1 < argv.length) args['default-repo'] = argv[++i];
     else if (arg === '--force' || arg === '-f') args.force = true;
     else if (arg === '--help' || arg === '-h') { printHelp(); process.exit(0); }
-    else if (!arg.startsWith('-')) args.command = arg;
+    else if (!arg.startsWith('-') && !args.command) args.command = arg;
+    else if (!arg.startsWith('-') && args.command && !args.subcommand) args.subcommand = arg;
   }
   return args;
 }
@@ -318,28 +374,49 @@ function printHelp() {
   console.log(`gitea-cli-skill - Install gitea-cli as an AI agent skill
 
 Usage:
-  npx gitea-cli-skill init [flags]
+  npx gitea-cli-skill init [flags]                          # Install skill
+  gitea-cli-skill add context [flags]                       # Configure Gitea API context
 
 Commands:
-  init              Install skill
+  init                    Install skill (download binary + SKILL.md)
+  add context             Add or update a Gitea API context (requires --token)
 
-Flags:
-  --token <t>       Gitea API token (or set GITEA_TOKEN env var)
+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
+
+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)
+
+Global:
   -h, --help        Show this help
 
 Platforms:
 ${platformList}
 
 Examples:
-  npx gitea-cli-skill init --local ../dist                     # from local build
-  npx gitea-cli-skill init --token abc123                      # from Gitea release
-  npx gitea-cli-skill init --token abc123 --platform cursor    # for Cursor
-  npx gitea-cli-skill init --local ../dist --target ~/custom   # custom dir
+  # Step 1: Install the skill (no token needed for public repos)
+  npx gitea-cli-skill init
+
+  # Step 2: Configure context
+  gitea-cli-skill add context --host https://gitea.example.com --token abc123
+
+  # Configure context with all options
+  gitea-cli-skill add context --name work --host https://gitea.example.com --token abc123 --default-owner myorg
+
+  # Or install + configure in one step (for private repos)
+  npx gitea-cli-skill init --token abc123
+
+  # Or install from local build
+  npx gitea-cli-skill init --local ../dist
 `);
 }
 
@@ -347,20 +424,22 @@ async function main() {
   const args = parseArgs(process.argv);
 
   if (!args.command) { printHelp(); process.exit(0); }
-  if (args.command !== 'init') {
-    console.error(`Unknown command: ${args.command}`);
-    console.error('Run with --help for usage.');
-    process.exit(1);
-  }
 
-  // Validate platform name
-  if (args.platform && !PLATFORMS[args.platform] && !args.target) {
-    console.error(`Unknown platform: ${args.platform}`);
-    console.error(`Available: ${Object.keys(PLATFORMS).join(', ')}, or use --target for custom path.`);
+  if (args.command === 'init') {
+    // Validate platform name
+    if (args.platform && !PLATFORMS[args.platform] && !args.target) {
+      console.error(`Unknown platform: ${args.platform}`);
+      console.error(`Available: ${Object.keys(PLATFORMS).join(', ')}, or use --target for custom path.`);
+      process.exit(1);
+    }
+    await install(args);
+  } else if (args.command === 'add' && args.subcommand === 'context') {
+    await addContext(args);
+  } else {
+    console.error(`Unknown command: ${args.command}${args.subcommand ? ' ' + args.subcommand : ''}`);
+    console.error('Run with --help for usage.');
     process.exit(1);
   }
-
-  await install(args);
 }
 
 main().catch((err) => {