@zenalexa/unicli 0.215.0 → 0.216.0

package/src/hub/external-clis.yaml

@@ -38,6 +38,91 @@
 
 # ── Tier 1 — AI Agent CLIs ──────────────────────────────────────────────
 
+- name: claude-code
+  binary: claude
+  description: "Claude Code — Anthropic coding agent CLI"
+  homepage: "https://www.anthropic.com/claude-code"
+  tags: [ai, agent, coding, claude, mcp]
+  json_flag: "--output-format stream-json"
+  install:
+    default: "npm install -g @anthropic-ai/claude-code"
+
+- name: codex-cli
+  binary: codex
+  description: "Codex CLI — OpenAI coding agent CLI"
+  homepage: "https://github.com/openai/codex"
+  tags: [ai, agent, coding, openai, codex, mcp]
+  json_flag: "--json"
+  install:
+    default: "npm install -g @openai/codex"
+
+- name: opencode-cli
+  binary: opencode
+  description: "OpenCode — coding agent CLI with ACP and native TUI surfaces"
+  homepage: "https://opencode.ai"
+  tags: [ai, agent, coding, opencode, acp, mcp]
+  json_flag: "--json"
+  install:
+    default: "npm install -g opencode-ai"
+
+- name: openclaw
+  binary: openclaw
+  description: "OpenClaw — multi-channel AI gateway"
+  homepage: "https://openclaw.ai"
+  tags: [ai, gateway, openclaw, acp]
+  install:
+    default: "npm install -g openclaw"
+
+- name: acpx
+  binary: acpx
+  description: "acpx — ACP bridge and workflow runner for coding agents"
+  homepage: "https://github.com/openclaw/acpx"
+  tags: [ai, agent, coding, openclaw, acp, bridge]
+  json_flag: "--json"
+  install:
+    default: "npm install -g acpx"
+
+- name: hermes-agent
+  binary: hermes
+  description: "Hermes Agent — local skills and session-oriented agent CLI"
+  homepage: "https://github.com/NousResearch/hermes-agent"
+  tags: [ai, agent, coding, hermes, skills]
+  json_flag: "--json"
+  install:
+    default: "curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash"
+
+- name: cursor-agent
+  binary: cursor-agent
+  description: "Cursor Agent — Cursor coding agent CLI"
+  homepage: "https://cursor.com"
+  tags: [ai, agent, coding, cursor, acp]
+
+- name: gemini-cli
+  binary: gemini
+  description: "Gemini CLI — Google open-source terminal coding agent"
+  homepage: "https://github.com/google-gemini/gemini-cli"
+  tags: [ai, agent, coding, google, gemini, mcp]
+  install:
+    default: "npm install -g @google/gemini-cli"
+
+- name: qwen-code
+  binary: qwen
+  description: "Qwen Code — open-source terminal coding agent"
+  homepage: "https://github.com/QwenLM/qwen-code"
+  tags: [ai, agent, coding, qwen, alibaba]
+  install:
+    default: "npm install -g @qwen-code/qwen-code"
+
+- name: kiro-cli
+  binary: kiro-cli
+  description: "Kiro CLI — Amazon Q successor terminal coding agent"
+  homepage: "https://kiro.dev/docs/cli"
+  tags: [ai, agent, coding, aws, kiro, mcp]
+  install:
+    mac: "curl -fsSL https://cli.kiro.dev/install | bash"
+    linux: "curl -fsSL https://cli.kiro.dev/install | bash"
+    default: "curl -fsSL https://cli.kiro.dev/install | bash"
+
 - name: kimi-cli
   binary: kimi
   description: "Kimi Code — Moonshot AI coding agent CLI, 8K★"
@@ -56,6 +141,96 @@
   install:
     default: "pip install deepagents-cli"
 
+- name: aider
+  binary: aider
+  description: "Aider — mature AI pair-programming CLI"
+  homepage: "https://github.com/Aider-AI/aider"
+  tags: [ai, agent, coding, aider, git]
+  install:
+    default: "pipx install aider-chat"
+
+- name: goose
+  binary: goose
+  description: "Goose — open-source extensible coding agent"
+  homepage: "https://github.com/aaif-goose/goose"
+  tags: [ai, agent, coding, goose, mcp]
+
+- name: amp
+  binary: amp
+  description: "Amp — Sourcegraph frontier coding agent"
+  homepage: "https://ampcode.com"
+  tags: [ai, agent, coding, sourcegraph, amp]
+  install:
+    default: "npm install -g @sourcegraph/amp"
+
+- name: github-copilot-cli
+  binary: copilot
+  description: "GitHub Copilot CLI — Copilot from the terminal"
+  homepage: "https://github.com/features/copilot"
+  tags: [ai, agent, coding, github, copilot]
+  install:
+    default: "npm install -g @github/copilot"
+
+- name: auggie
+  binary: auggie
+  description: "Auggie CLI — Augment Code agentic terminal"
+  homepage: "https://augmentcode.com"
+  tags: [ai, agent, coding, augment, auggie]
+  install:
+    default: "npm install -g @augmentcode/auggie"
+
+- name: crush
+  binary: crush
+  description: "Charm Crush — open-source terminal coding agent"
+  homepage: "https://github.com/charmbracelet/crush"
+  tags: [ai, agent, coding, charm, crush]
+
+- name: openhands
+  binary: openhands
+  description: "OpenHands — AI-driven development agent and sandbox"
+  homepage: "https://github.com/OpenHands/OpenHands"
+  tags: [ai, agent, coding, openhands, sandbox]
+  install:
+    default: "pipx install openhands-ai"
+
+- name: mini-swe-agent
+  binary: mini
+  description: "mini-SWE-agent — small reproducible software-engineering agent"
+  homepage: "https://github.com/SWE-agent/mini-swe-agent"
+  tags: [ai, agent, coding, swe, benchmark]
+  install:
+    default: "pipx install mini-swe-agent"
+
+- name: swe-agent
+  binary: sweagent
+  description: "SWE-agent — reproducible software-engineering agent harness"
+  homepage: "https://github.com/SWE-agent/SWE-agent"
+  tags: [ai, agent, coding, swe, benchmark]
+
+- name: agentapi
+  binary: agentapi
+  description: "AgentAPI — HTTP/SSE control plane for native coding-agent CLIs"
+  homepage: "https://github.com/coder/agentapi"
+  tags: [ai, agent, coding, bridge, http]
+
+- name: droid-cli
+  binary: droid
+  description: "Droid CLI — Factory AI terminal coding agent"
+  homepage: "https://factory.ai"
+  tags: [ai, agent, coding, factory, droid]
+
+- name: forgecode
+  binary: forge
+  description: "ForgeCode — terminal AI pair-programming agent"
+  homepage: "https://antinomy.ai/"
+  tags: [ai, agent, coding, forgecode]
+
+- name: rovo-dev
+  binary: rovo
+  description: "Rovo Dev CLI — Atlassian team coding agent"
+  homepage: "https://www.atlassian.com/software/rovo"
+  tags: [ai, agent, coding, atlassian, rovo]
+
 # ── Tier 1 — Essential ──────────────────────────────────────────────────
 
 - name: vercel

package/src/hub/index.ts

@@ -1,12 +1,12 @@
 /**
  * External CLI Hub — registry and auto-discovery for third-party CLIs.
  *
- * Reads `external-clis.yaml` at startup, checks which binaries are
+ * Reads the external CLI registries at startup, checks which binaries are
  * installed on $PATH, and exposes lookup helpers for the rest of the
  * system (Commander registration, `unicli ext` subcommands, AGENTS.md).
  */
 
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
@@ -30,6 +30,7 @@ export interface ExternalCli {
 
 let _cache: ExternalCli[] | null = null;
 const _installedCache = new Map<string, boolean>();
+const REGISTRY_FILES = ["external-clis.yaml", "external-clis-harness.yaml"];
 
 // ── Loader ──────────────────────────────────────────────────────────────
 
@@ -40,26 +41,35 @@ const _installedCache = new Map<string, boolean>();
  * At runtime we may be executing from `dist/hub/`, so we try the source
  * sibling first (`../../src/hub/`) then fall back to the co-located path.
  */
-function resolveYamlPath(): string {
+function resolveYamlPath(fileName: string): string | null {
   // Running from dist/hub/index.js → ../../src/hub/external-clis.yaml
-  const fromDist = join(
-    __dirname,
-    "..",
-    "..",
-    "src",
-    "hub",
-    "external-clis.yaml",
-  );
+  const fromDist = join(__dirname, "..", "..", "src", "hub", fileName);
   // Running from src/hub/index.ts (dev via tsx)
-  const fromSrc = join(__dirname, "external-clis.yaml");
+  const fromSrc = join(__dirname, fileName);
 
   // Prefer the source copy (always present in both dev & installed package)
-  try {
-    readFileSync(fromSrc, "utf-8");
-    return fromSrc;
-  } catch {
-    return fromDist;
-  }
+  if (existsSync(fromSrc)) return fromSrc;
+  if (existsSync(fromDist)) return fromDist;
+  return null;
+}
+
+function readRegistryFile(fileName: string): ExternalCli[] {
+  const path = resolveYamlPath(fileName);
+  if (!path) return [];
+
+  const raw = readFileSync(path, "utf-8");
+  const parsed = yaml.load(raw);
+  return Array.isArray(parsed) ? (parsed as ExternalCli[]) : [];
+}
+
+function dedupeRegistry(entries: ExternalCli[]): ExternalCli[] {
+  const seen = new Set<string>();
+  return entries.filter((entry) => {
+    const key = `${entry.name}\0${entry.binary}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
 }
 
 /**
@@ -70,13 +80,7 @@ export function loadExternalClis(): ExternalCli[] {
   if (_cache) return _cache;
 
   try {
-    const raw = readFileSync(resolveYamlPath(), "utf-8");
-    const parsed = yaml.load(raw);
-    if (!Array.isArray(parsed)) {
-      _cache = [];
-      return _cache;
-    }
-    _cache = parsed as ExternalCli[];
+    _cache = dedupeRegistry(REGISTRY_FILES.flatMap(readRegistryFile));
     return _cache;
   } catch {
     _cache = [];

package/src/adapters/linux-do/search.yaml

@@ -1,44 +0,0 @@
-site: linux-do
-name: search
-description: Search Linux.do forum topics
-domain: linux.do
-type: web-api
-strategy: public
-
-args:
-  query:
-    required: true
-    positional: true
-    description: Search query
-  limit:
-    type: int
-    default: 20
-    description: Number of results
-
-pipeline:
-  - fetch:
-      url: https://linux.do/search.json
-      params:
-        q: "${{ args.query }}"
-
-  - select: topics
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      views: ${{ item.views }}
-      likes: ${{ item.like_count }}
-      replies: ${{ (item.posts_count || 1) - 1 }}
-      url: ${{ 'https://linux.do/t/topic/' + item.id }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, views, likes, replies, url]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/meituan/hot.yaml

@@ -1,34 +0,0 @@
-site: meituan
-name: hot
-description: Meituan hot search keywords
-domain: apimobile.meituan.com
-type: web-api
-strategy: public
-
-args:
-  limit:
-    type: int
-    default: 20
-
-pipeline:
-  - fetch:
-      url: https://apimobile.meituan.com/group/v1/recommend/hotword/1
-
-  - select: data.hotSearchWords
-
-  - map:
-      rank: ${{ index + 1 }}
-      keyword: "${{ item.word || item }}"
-      count: "${{ item.count || '' }}"
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, keyword, count]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/frontpage.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit frontpage", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "frontpage");
-    expectAdapterShape(output, {
-      columns: ["rank", "title", "subreddit", "score", "comments", "author"],
-      minItems: 1,
-    });
-  });
-});

package/src/adapters/reddit/frontpage.yaml

@@ -1,41 +0,0 @@
-site: reddit
-name: frontpage
-description: Reddit front page / r/all
-domain: www.reddit.com
-type: web-api
-strategy: public
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of posts
-
-pipeline:
-  - fetch:
-      url: https://www.reddit.com/r/all.json
-      params:
-        limit: ${{ args.limit }}
-        raw_json: "1"
-  - select: data.children
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.data.title }}
-      subreddit: ${{ item.data.subreddit_name_prefixed }}
-      score: ${{ item.data.score }}
-      comments: ${{ item.data.num_comments }}
-      author: ${{ item.data.author }}
-      url: ${{ item.data.url }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, subreddit, score, comments, author]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/hot.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit hot", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "hot");
-    expectAdapterShape(output, {
-      columns: ["rank", "title", "subreddit", "score", "comments", "author"],
-      minItems: 1,
-    });
-  });
-});

package/src/adapters/reddit/hot.yaml

@@ -1,41 +0,0 @@
-site: reddit
-name: hot
-description: Reddit front page hot posts
-domain: www.reddit.com
-type: web-api
-strategy: public
-browser: false
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of posts
-
-pipeline:
-  - fetch:
-      url: https://www.reddit.com/r/all/hot.json
-      params:
-        limit: ${{ args.limit }}
-  - select: data.children
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.data.title }}
-      subreddit: ${{ item.data.subreddit_name_prefixed }}
-      score: ${{ item.data.score }}
-      comments: ${{ item.data.num_comments }}
-      author: ${{ item.data.author }}
-      url: ${{ item.data.url }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, subreddit, score, comments, author]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/new.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit new", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "new");
-    expectAdapterShape(output, {
-      columns: ["title", "author", "subreddit", "score", "comments"],
-      minItems: 1,
-    });
-  });
-});

package/src/adapters/reddit/new.yaml

@@ -1,42 +0,0 @@
-site: reddit
-name: new
-description: Reddit newest posts from all subreddits
-domain: www.reddit.com
-type: web-api
-strategy: public
-
-args:
-  subreddit:
-    type: str
-    description: Subreddit name (without r/)
-  limit:
-    type: int
-    default: 20
-
-pipeline:
-  - fetch:
-      url: "https://www.reddit.com/${{ args.subreddit ? 'r/' + args.subreddit + '/' : '' }}new.json"
-      params:
-        limit: "${{ args.limit }}"
-
-  - select: data.children
-
-  - map:
-      title: "${{ item.data.title }}"
-      author: "${{ item.data.author }}"
-      subreddit: "${{ item.data.subreddit }}"
-      score: "${{ item.data.score }}"
-      comments: "${{ item.data.num_comments }}"
-      url: "${{ 'https://www.reddit.com' + item.data.permalink }}"
-
-  - limit: ${{ args.limit }}
-
-columns: [title, author, subreddit, score, comments]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/popular.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit popular", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "popular");
-    expectAdapterShape(output, {
-      columns: ["rank", "title", "subreddit", "score", "comments", "author"],
-      minItems: 1,
-    });
-  });
-});

package/src/adapters/reddit/popular.yaml

@@ -1,41 +0,0 @@
-site: reddit
-name: popular
-description: Reddit popular posts (/r/popular)
-domain: www.reddit.com
-type: web-api
-strategy: public
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of posts
-
-pipeline:
-  - fetch:
-      url: https://www.reddit.com/r/popular.json
-      params:
-        limit: ${{ args.limit }}
-        raw_json: "1"
-  - select: data.children
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.data.title }}
-      subreddit: ${{ item.data.subreddit_name_prefixed }}
-      score: ${{ item.data.score }}
-      comments: ${{ item.data.num_comments }}
-      author: ${{ item.data.author }}
-      url: ${{ item.data.url }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, subreddit, score, comments, author]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/rising.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit rising", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "rising");
-    expectAdapterShape(output, {
-      columns: ["title", "author", "subreddit", "score", "comments"],
-      minItems: 1,
-    });
-  });
-});

package/src/adapters/reddit/rising.yaml

@@ -1,41 +0,0 @@
-site: reddit
-name: rising
-description: Reddit rising posts
-domain: www.reddit.com
-type: web-api
-strategy: public
-
-args:
-  subreddit:
-    type: str
-    description: Subreddit name (without r/)
-  limit:
-    type: int
-    default: 20
-
-pipeline:
-  - fetch:
-      url: "https://www.reddit.com/${{ args.subreddit ? 'r/' + args.subreddit + '/' : '' }}rising.json"
-      params:
-        limit: "${{ args.limit }}"
-
-  - select: data.children
-
-  - map:
-      title: "${{ item.data.title }}"
-      author: "${{ item.data.author }}"
-      subreddit: "${{ item.data.subreddit }}"
-      score: "${{ item.data.score }}"
-      comments: "${{ item.data.num_comments }}"
-
-  - limit: ${{ args.limit }}
-
-columns: [title, author, subreddit, score, comments]
-
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
-capabilities: ["http.fetch"]
-minimum_capability: http.fetch
-trust: public
-confidentiality: public
-quarantine: false
-schema_version: v2

package/src/adapters/reddit/search.test.ts

@@ -1,15 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  runAdapterWithFixture,
-  expectAdapterShape,
-} from "../../../tests/adapter-runner.js";
-
-describe("reddit search", () => {
-  it("returns rows with declared columns against fixture", async () => {
-    const { output } = await runAdapterWithFixture("reddit", "search");
-    expectAdapterShape(output, {
-      columns: ["rank", "title", "subreddit", "score", "comments", "author"],
-      minItems: 1,
-    });
-  });
-});