api2cli 0.3.14 → 0.3.16

package/README.md

@@ -103,7 +103,7 @@ program.addCommand(draftsResource);
 ### 3. Build and link
 
 ```bash
-api2cli bundle <app>        # Build the CLI (~5KB JS bundle)
+api2cli bundle <app>        # Build the CLI
 api2cli link <app>          # Add to PATH (updates .bashrc/.zshrc)
 ```
 
@@ -122,18 +122,16 @@ api2cli link <app>          # Add to PATH (updates .bashrc/.zshrc)
 | Command | Description |
 |---------|-------------|
 | `api2cli create <app>` | Generate a new CLI from API docs |
-| `api2cli bundle <app>` | Build a CLI from source |
-| `api2cli bundle --all` | Build all installed CLIs |
-| `api2cli link <app>` | Add a CLI to PATH |
-| `api2cli link --all` | Link all CLIs |
+| `api2cli bundle <app> [--compile] [--all]` | Build a CLI from source (`--compile` for standalone binary) |
+| `api2cli link <app> [--all]` | Add a CLI to PATH |
 | `api2cli unlink <app>` | Remove from PATH |
-| `api2cli list` | List all installed CLIs |
-| `api2cli tokens` | List all configured tokens (masked) |
-| `api2cli remove <app>` | Remove a CLI entirely |
+| `api2cli list [--json]` | List all installed CLIs |
+| `api2cli tokens [--show]` | List all configured tokens (masked) |
+| `api2cli remove <app> [--keep-token]` | Remove a CLI entirely |
 | `api2cli doctor` | Check system requirements |
-| `api2cli install <app>` | Install from registry (coming soon) |
-| `api2cli publish <app>` | Publish to registry (coming soon) |
-| `api2cli update <app>` | Re-sync with API changes |
+| `api2cli install <source> [--force]` | Install from GitHub repo or registry |
+| `api2cli publish <app> [--github <url>] [--category <cat>]` | Publish to registry |
+| `api2cli update <app>` | Re-sync with API changes (agent-driven) |
 
 ### Generated CLIs (`<app>-cli`)
 

package/dist/index.js

@@ -2690,7 +2690,7 @@ ${import_picocolors4.default.bold("Installing")} ${import_picocolors4.default.cy
   console.log(`  ${import_picocolors4.default.green("+")} Built`);
   addToPath(app, distDir);
   symlinkSkill(cliDir, appCli);
-  const trackName = skillName ?? getAppName(repo);
+  const trackName = skillName ?? (repo.endsWith("-cli") ? repo : `${repo}-cli`);
   fetch(`${REGISTRY_API}/skills/${trackName}/download`, { method: "POST" }).catch(() => {});
   console.log(`
 ${import_picocolors4.default.green("\u2713")} Installed ${import_picocolors4.default.bold(appCli)}`);
@@ -2803,11 +2803,40 @@ async function buildCli(app, compile) {
 
 // src/commands/link.ts
 var import_picocolors7 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync9, readdirSync as readdirSync5 } from "fs";
-var linkCommand = new Command("link").description("Add a CLI to your PATH").argument("[app]", "CLI to link (omit with --all)").option("--all", "Link all installed CLIs").addHelpText("after", `
+import { existsSync as existsSync9, mkdirSync as mkdirSync5, readdirSync as readdirSync5, symlinkSync as symlinkSync3, unlinkSync as unlinkSync3 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join8 } from "path";
+var AGENT_SKILL_DIRS = {
+  claude: join8(homedir4(), ".claude", "skills"),
+  cursor: join8(homedir4(), ".cursor", "skills"),
+  openclaw: join8(homedir4(), ".openclaw", "workspace", "skills")
+};
+function linkSkill(app, skillsPath) {
+  const cliDir = getCliDir(app);
+  const skillSource = join8(cliDir, "skills", `${app}-cli`, "SKILL.md");
+  if (!existsSync9(skillSource)) {
+    console.log(`  ${import_picocolors7.default.dim("No SKILL.md found for")} ${app}-cli${import_picocolors7.default.dim(", skipping skill link")}`);
+    return;
+  }
+  const targetDir = join8(skillsPath, `${app}-cli`);
+  mkdirSync5(targetDir, { recursive: true });
+  const targetLink = join8(targetDir, "SKILL.md");
+  if (existsSync9(targetLink))
+    unlinkSync3(targetLink);
+  symlinkSync3(skillSource, targetLink);
+  console.log(`${import_picocolors7.default.green("+")} Skill linked ${import_picocolors7.default.bold(`${app}-cli`)} -> ${import_picocolors7.default.dim(targetLink)}`);
+}
+var linkCommand = new Command("link").description("Add a CLI to your PATH (and optionally link skills to agent directories)").argument("[app]", "CLI to link (omit with --all)").option("--all", "Link all installed CLIs").option("--openclaw", "Also symlink skill to ~/.openclaw/workspace/skills/").option("--skills-path <path>", "Custom path to symlink the skill into").addHelpText("after", `
 Examples:
   api2cli link typefully
-  api2cli link --all`).action((app, opts) => {
+  api2cli link typefully --openclaw
+  api2cli link typefully --skills-path ~/.openclaw/workspace/skills
+  api2cli link --all --openclaw`).action((app, opts) => {
+  const skillsPaths = [];
+  if (opts.openclaw)
+    skillsPaths.push(AGENT_SKILL_DIRS.openclaw);
+  if (opts.skillsPath)
+    skillsPaths.push(opts.skillsPath.replace(/^~/, homedir4()));
   if (opts.all || !app) {
     if (!existsSync9(CLI_ROOT)) {
       console.log("No CLIs installed.");
@@ -2817,6 +2846,8 @@ Examples:
     for (const d of dirs) {
       const name = d.replace(/-cli$/, "");
       addToPath(name, getDistDir(name));
+      for (const sp of skillsPaths)
+        linkSkill(name, sp);
     }
     return;
   }
@@ -2825,6 +2856,8 @@ Examples:
     process.exit(1);
   }
   addToPath(app, getDistDir(app));
+  for (const sp of skillsPaths)
+    linkSkill(app, sp);
 });
 
 // src/commands/unlink.ts
@@ -2837,7 +2870,7 @@ Example:
 // src/commands/tokens.ts
 var import_picocolors8 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync10, readdirSync as readdirSync6, readFileSync as readFileSync4 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 var tokensCommand = new Command("tokens").description("List all configured API tokens").option("--show", "Show full unmasked tokens").addHelpText("after", `
 Examples:
   api2cli tokens
@@ -2856,7 +2889,7 @@ ${import_picocolors8.default.bold("Configured tokens:")}
 `);
   for (const f of files) {
     const name = f.replace(".txt", "");
-    const token = readFileSync4(join8(TOKENS_DIR, f), "utf-8").trim();
+    const token = readFileSync4(join9(TOKENS_DIR, f), "utf-8").trim();
     const display = opts.show ? token : token.length > 8 ? `${token.slice(0, 4)}${import_picocolors8.default.dim("...")}${token.slice(-4)}` : import_picocolors8.default.dim("****");
     console.log(`  ${import_picocolors8.default.bold(name.padEnd(25))} ${display}`);
   }
@@ -2936,7 +2969,7 @@ var import_picocolors11 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync13 } from "fs";
 var updateCommand = new Command("update").description("Re-sync a CLI when the upstream API changes").argument("<app>", "CLI to update").option("--docs <url>", "Updated API documentation URL").option("--openapi <url>", "Updated OpenAPI spec URL").addHelpText("after", `
 Example:
-  api2cli update typefully --docs https://docs.typefully.com`).action(async (app) => {
+  api2cli update typefully --docs https://docs.typefully.com`).action(async (app, opts) => {
   const cliDir = getCliDir(app);
   if (!existsSync13(cliDir)) {
     console.error(`${import_picocolors11.default.red("\u2717")} ${app}-cli not found. Run: ${import_picocolors11.default.cyan(`api2cli create ${app}`)}`);
@@ -2946,6 +2979,13 @@ Example:
   console.log(`
 Use your AI agent to update resources in:`);
   console.log(`  ${import_picocolors11.default.dim(`${cliDir}/src/resources/`)}`);
+  if (opts.docs) {
+    console.log(`
+API docs: ${import_picocolors11.default.cyan(opts.docs)}`);
+  }
+  if (opts.openapi) {
+    console.log(`OpenAPI spec: ${import_picocolors11.default.cyan(opts.openapi)}`);
+  }
   console.log(`
 Then rebuild: ${import_picocolors11.default.cyan(`api2cli bundle ${app}`)}`);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api2cli",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "description": "Turn any REST API into a standardized, agent-ready CLI",
   "type": "module",
   "bin": {