diff --git a/README.md b/README.md index 95d3614..3346f21 100644 --- a/README.md +++ b/README.md @@ -1,25 +1,22 @@ -

  CLI-Anything: Making ALL Software Agent-Native

+ +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/HKUDS/CLI-Anything) · [上游 README](https://github.com/HKUDS/CLI-Anything/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 -
-HKUDS%2FCLI-Anything | Trendshift -
+

  CLI-Anything: 让所有软件都能被 Agent 驱动

- Today's Software Serves Humans👨‍💻. Tomorrow's Users will be Agents🤖.
-CLI-Anything: Bridging the Gap Between AI Agents and the World's Software
+ 今天的软件为人而生👨‍💻，明天的用户是 Agent🤖
+CLI-Anything：连接 AI Agent 与全世界软件的桥梁

-**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: `pip install cli-anything-hub` then `cli-hub install ` — browse, install, and manage all community-built CLIs. Want to add your own? [Open a PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — the hub updates instantly. - -**🎬 [See Demos](#-real-world-demos)**: Watch AI agents use generated CLIs plus preview, live preview, and trajectory loops to produce real artifacts — CAD builds, 3D scenes, diagrams, gameplay, subtitles, and more. - -**🙋 [Become a Contributor, or Request a CLI]**: [Join us](https://github.com/HKUDS/CLI-Anything/issues/new?template=contributor-signup.yml)! Sign up to build a new CLI harness — once reviewed and merged, you'll gain access as one of our community contributors! Wish CLI-Anything supported a specific software or service? Submit a [wishlist request](https://github.com/HKUDS/CLI-Anything/issues/new?template=cli-wishlist.yml)! +**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**：在 **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** 探索社区已构建的所有 CLI，一条命令即可安装。想贡献你的 CLI？[提交 PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — Hub 会即时更新。

- Quick Start - CLI Hub - Demos - Tests + Quick Start + Demos + Tests Tech Report License

@@ -30,11 +27,11 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software Coverage Output - Feishu -WeChat + Feishu +WeChat

-**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc.  [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md) | [**Deutsch**](README_DE.md) +**一行命令**，让任意软件接入 OpenClaw、nanobot、Cursor、Claude Code 等 Agent 框架。

CLI-Anything typing demo @@ -46,302 +43,118 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software Thanks to all invaluable efforts from the community! More updates continuously on the way everyday.. +CLI 是人类和 AI Agent 共通的万能接口： -- **2026-05-30** 🧭 **Hermes skill** proposed (#320), adding a CLI-Anything orchestration skill with installer scripts and HARNESS fallback guidance. 🗺️ **ArcGIS Pro** was proposed for the public registry (#318) as a Windows/ArcPy CLI for cartography, geoprocessing, feature editing, and live-Pro MCP workflows. +• **结构化、可组合** - 文本命令天然匹配 LLM 的输入格式，可自由串联成复杂工作流 -- **2026-05-27** 🔧 **CLI-Hub** registry date updates now handle `python -m pip` install commands (#312), improving package-date detection for registry automation. +• **轻量且通用** - 几乎零开销，跨平台运行，不依赖额外环境 -- **2026-05-23** 📝 **Obsidian Agent CLI** was proposed for the public registry (#307), bringing a PyPI-installed Obsidian automation CLI with persistent agent memory workflows and a pinned skill link. +• **自描述** - 一个 `--help` 就能让 Agent 自动发现所有功能 -- **2026-05-21** 🔒 **Sketch CLI** token-file handling was hardened against path traversal and symlink escapes (#304). +• **久经验证** - Claude Code 每天通过 CLI 执行数以千计的真实任务 -- **2026-05-20** 📓 **Joplin CLI** was proposed (#300) with notebooks, notes, to-dos, tags, attachments, search/sync, import/export, server/E2EE helpers, full docs, packaged skill docs, and a 134-test validation baseline. +• **Agent 友好** - 结构化 JSON 输出，Agent 无需任何额外解析 -- **2026-05-20** 🎛️ **Rekordbox CLI** merged (#252) with guarded SQLCipher write paths, backup-required forced writes, smoke coverage, and root skill sync. 📚 **Calibre CLI** merged (#223) with library/search/metadata/conversion/export workflows, 41 unit tests, real-Calibre E2E evidence, and root skill validation. 🧊 **3MF CLI** merged (#209) with mesh inspection, hole resizing, repair, comparison, and preserved triangle attributes. 🎙️ **MiniMax CLI** merged (#189) with chat/TTS workflows, JSON-safe model/voice listing, REPL quote handling, and smoke/E2E coverage. 🎮 **UEAtelier** joined the registry (#297) as an Unreal Editor MCP self-extension workbench with a Python CLI proxy. +• **确定且可靠** - 输出稳定一致，Agent 行为可预测 -- **2026-05-19** 🛠️ Existing harnesses got a quality/security pass — **Zoom** downloads recordings from direct URLs (#294), **Obsidian** search now uses the Local REST API vendor content types (#289), **LibreOffice** headless conversion is more robust on macOS (#290), and XML/SVG/ODF/MLT/MusicXML/CSL parsing now routes untrusted input through `defusedxml` (#296). +## 🚀 快速上手 -- **2026-05-18** 📈 README presentation refreshed with the Trendshift badge and centered project header polish (#285, #286), keeping the landing section focused on discovery and project momentum. - -- **2026-05-17** 🌐 **CLI-Hub** registry handling was hardened (#281) — registry entries are now copied before `_source` tagging, preventing cached or mocked registry data from being mutated in place. - -- **2026-05-16** 🔧 **n8n** received the REPL banner crash fix that later merged into main (#280), restoring the no-subcommand interactive startup path with regression coverage. - -

-Earlier news (Apr 10–18) - -- **2026-04-18** 🧩 **All SKILL.md files are now being unified under the top-level `skills/` directory** — every CLI skill can be installed from one canonical source with `npx skills add HKUDS/CLI-Anything --skill -g -y`. We also added root-skill validation CI, synced contribution / PR docs and REPL skill-path hints to the new layout, and refreshed the **CLI-Hub** install-first frontend around the new `npx skills` flow. - -- **2026-04-17** 🌐 **CLI-Hub** received another install UX pass — public registry metadata and skill coverage were tightened, visit counting was corrected, and the web hub was further refined. 🧪 **Shotcut** render output duration was fixed (#92). 📝 **SKILL** contribution paths were corrected for the new docs flow (#224), and the skill generator now safely handles empty intros (#203). - -- **2026-04-16** 🗺️ **QGIS CLI** merged (#207) — a full GIS / map authoring harness landed. 🧬 **UniMol Tools CLI** merged (#219) for molecular modeling workflows. 🌐 **CLI-Hub** also added more public CLIs, including **py4csr**, refreshed its generated meta-skill, corrected SKILL contribution docs, and fixed `apt-get` package extraction in skill generation (#204). - -- **2026-04-16** 📈 **Unreal Insights CLI** expanded — added background capture session control (`capture start/status/snapshot/stop`), engine-root-matched `UnrealInsights.exe` resolution/build flows, and refreshed docs/tests for the new orchestration workflow. - -- **2026-04-15** 🌐 **CLI-Hub** updated to **v0.2.0** — the PyPI package now supports public CLIs from multiple install sources (`pip`, `npm`, `brew`, bundled/system tools), backed by a new `public_registry.json`. The Hub frontend was redesigned with separate **CLI-Anything CLIs** and **Public CLIs** decks, and live end-to-end checks now cover real install, update, and uninstall flows across both pip and npm packages. - -- **2026-04-14** 🧭 **Safari CLI** merged (#212) and added to the Hub registry — browser automation via `safari-mcp`. 🎬 **Kdenlive** also received compatibility fixes for Gen 5 project output and invalid project generation. - -- **2026-04-13** 📓 **Obsidian CLI** merged (#211) — knowledge management harness via the Local REST API, with 48 unit tests and 7 E2E tests. ⛓️ **Eth2-Quickstart CLI** merged (#195) — Ethereum staking node management harness. 📚 **Zotero CLI** updated to v0.4.1 (#201) — now shipped from its standalone repo, and CLI-Hub gained support for remote `skill_md` URLs. - -- **2026-04-11** 🔗 **n8n CLI** merged (#188) — workflow automation harness for self-hosted automation flows. 🔧 **Exa CLI** fix (#205) added the `x-exa-integration` header for usage tracking. 📦 **CLI-Hub** also gained its PyPI auto-publish workflow and package refresh pipeline. - -- **2026-04-10** 📦 **CLI-Hub package manager** launched — `pip install cli-anything-hub` to browse, search, install, update, and uninstall CLI-Anything harnesses from one command. The web Hub also shipped its first install-focused frontend refresh and "Empower yourself" toolkit card. - -
- -
-Earlier news (Apr 1–9) - -- **2026-04-09** 🧹 Cleanup and docs pass (#200) — fixed Openscreen test subtotals, added Openscreen to the Chinese README and project structure, and clarified `/cli-anything` command syntax in the docs. - -- **2026-04-08** 🎬 **Openscreen CLI** merged (#183) — screen recording editor harness with 101 tests. ☁️ **CloudAnalyzer CLI** merged (#181) — cloud cost analysis harness with 27 commands. 🌊 **SeaClip / PM2 / ChromaDB** harnesses merged (#129). - -- **2026-04-07** 🔄 **Dify Workflow CLI** merged (#191) — workflow automation wrapper. 🔧 **Inkscape** auto-save fix (#193, fixes #182). 🛡️ **DomShell security hardening** (#156) — URL validation and DOM sanitization for the browser CLI. 🥧 **Pi Coding Agent extension** merged (#178). - -- **2026-04-06** 🔍 **Exa CLI** merged (#172) — AI-powered web search and answers harness. 🎮 **Godot CLI** merged (#140) — game engine harness with a full demo-game E2E pipeline. ☁️ **CloudAnalyzer** review fixes and frontend improvements also landed. - -- **2026-04-03** 🧪 **WireMock CLI** merged (#170) — HTTP mock server harness for API testing. 🥧 **Pi Coding Agent** extension support also landed, and CLI demo recordings were added to the docs. - -- **2026-04-01** ⚔️ **Slay the Spire II CLI** merged (#148) — deck-building roguelike harness. 🎥 **VideoCaptioner CLI** merged (#166) — AI-powered video captioning harness. 🛰️ **IntelWatch** was added to the registry for B2B OSINT workflows. - -
- -
-Earlier news (Mar 23–30) - -- **2026-03-30** 🏗️ **CLI-Anything v0.2.0** — HARNESS.md progressive disclosure redesign. Detailed guides extracted into `guides/` for on-demand loading. Phases 1–7 now contiguous. Key Principles and Rules merged into a single authoritative section. - -- **2026-03-29** 📐 Blender skill docs updated — enforce absolute render paths and correct prerequisites. - -- **2026-03-28** 🌐 **CLIBrowser** added to CLI-Hub registry for agent-accessible browser automation. - -- **2026-03-27** 📚 Zotero SKILL.md enhanced with agent-facing constraints; REPL config and executable resolution fixes. - -- **2026-03-26** 📖 **Zotero CLI** harness landed for Zotero desktop (library management, collections, citations). Draw.io custom ID bugfix (#132) and registry.json syntax fix. - -- **2026-03-25** 🎮 **RenderDoc CLI** merged for GPU frame capture analysis. FreeCAD updated for v1.1. Blender EEVEE engine name corrected. Zoom token permissions hardened. - -- **2026-03-24** 🏭 **FreeCAD CLI** added with 258 commands across 17 groups. **iTerm2** and **Teltonika RMS** harnesses added to registry. - -- **2026-03-23** 🤖 Launched **CLI-Hub meta-skill** — agents can now discover and install CLIs autonomously. **Krita CLI** harness merged for digital painting. - -
- -
-Earlier news (Mar 11–22) - -- **2026-03-22** 🎵 **MuseScore CLI** merged with transpose, export, and instrument management. - -- **2026-03-21** 🔧 Infrastructure improvements — refined test harnesses and documentation across multiple CLIs. Enhanced Windows compatibility for several backends. - -- **2026-03-20** 🌐 **Novita AI** CLI added for OpenAI-compatible API access. Registry metadata improvements for better hub discovery. - -- **2026-03-19** 📦 Package structure refinements across harnesses. Improved SKILL.md generation with better command documentation. - -- **2026-03-18** 🧪 Test coverage expansion — additional E2E scenarios and edge case validation across multiple CLIs. - -- **2026-03-17** 🌐 Launched the **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** — a central registry where you can browse, search, and install any CLI with a single `pip` command. - -- **2026-03-16** 🤖 Added **SKILL.md generation** (Phase 6.5) — every generated CLI now ships with an AI-discoverable skill definition. - -- **2026-03-15** 🐾 Support for **OpenClaw** from the community! Merged Windows `cygpath` guard for cross-platform support. - -- **2026-03-14** 🔒 Fixed a GIMP Script-Fu path injection vulnerability and added **Japanese README** translation. - -- **2026-03-13** 🔌 **Qodercli** plugin officially merged as a community contribution with dedicated setup scripts. - -- **2026-03-12** 📦 **Codex skill** integration landed, bringing CLI-Anything to yet another AI coding platform. - -- **2026-03-11** 📞 **Zoom** video conferencing harness added as the 11th supported application. - -
- ---- - -## 🤔 Why CLI? - -CLI is the universal interface for both humans and AI agents: - -• **Structured & Composable** - Text commands match LLM format and chain for complex workflows - -• **Lightweight & Universal** - Minimal overhead, works across all systems without dependencies - -• **Self-Describing** - --help flags provide automatic documentation agents can discover - -• **Proven Success** - Claude Code runs thousands of real workflows through CLI daily - -• **Agent-First Design** - Structured JSON output eliminates parsing complexity - -• **Deterministic & Reliable** - Consistent results enable predictable agent behavior - -## 🚀 Quick Start - -CLI-Anything has two equally useful starting points: - -| Goal | Start Here | -|------|------------| -| **Use the existing CLI ecosystem now** | Install `cli-anything-hub`, browse the registry, and install ready-made CLIs. | -| **Build a new agent-native CLI** | Install the CLI-Anything plugin/skill for your agent, then run the 7-phase harness generator. | - -
-Phase 1: Empower yourself — your CLI toolkit - -Install the CLI-Hub package manager first. It lets you browse, search, inspect, install, update, uninstall, and launch CLI-Anything harnesses plus public third-party CLIs from one command. - -**PIP** - -```bash -pip install cli-anything-hub -``` - -| Command | What it does | -|---------|--------------| -| `cli-hub list` | Browse the registry | -| `cli-hub search ` | Search by keyword | -| `cli-hub info ` | Inspect one CLI | -| `cli-hub install ` | Install from CLI-Hub | -| `cli-hub update ` | Update an install | -| `cli-hub uninstall ` | Remove an install | -| `cli-hub launch [args...]` | Run an installed CLI | - -```bash -# Browse what is available -cli-hub list -cli-hub search image - -# Install and try a CLI immediately -cli-hub install gimp -cli-hub info gimp -cli-hub launch gimp -``` - -> Some CLIs wrap real desktop or backend software. If a selected CLI needs GIMP, Blender, LibreOffice, or another upstream tool, install that upstream application too. - -
- -
-Phase 1.5: Empower your agents — install in one command - -Give SKILL-compatible agents the CLI-Hub meta-skill so they can discover and install the right CLI for a task. - -**Also available on:** [ClawHub](https://clawhub.ai/yuh-yang/cli-anything-hub), [SkillHub](https://www.skillhub.club/web/skills/itsyuhao-cli-anything-hub), [SkillHub.cn](https://skillhub.cn/skills/cli-hub-meta-skill) - -**NPX SKILLS** - -```bash -npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y -``` - -**Works with:** OpenClaw, Nanobot, Claude Code, Codex, Reasonix, Antigravity, and other SKILL-compatible agents. - -Then prompt: - -```text -Find appropriate CLI software in CLI-Hub and complete the task: ... -``` - -
- -
-Phase 3: Build a new CLI when the registry does not have one yet - -Use the CLI-Anything generator when you need a new harness for software, a codebase, or an internal tool that is not already available through CLI-Hub. - -**Prerequisites** +### 环境要求 - **Python 3.10+** -- Target software or source repo available locally or online -- A supported AI coding agent: [Claude Code](#-claude-code) | [Pi](#-pi-coding-agent) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Hermes](#-hermes) | [Reasonix](#-reasonix) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [More Platforms](#-more-platforms-coming-soon) +- 目标软件已安装（如 GIMP、Blender、LibreOffice 或你自己的应用） +- 支持的 AI 编程工具之一：[Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [更多平台](#-更多平台即将支持) -### Pick Your Agent Platform +### 选择你的平台

⚡ Claude Code

 -**Step 1: Add the Marketplace** +**第一步：添加插件市场** -CLI-Anything is distributed as a Claude Code plugin marketplace hosted on GitHub. +CLI-Anything 以 Claude Code 插件市场的形式托管在 GitHub 上。 ```bash -# Add the CLI-Anything marketplace +# 添加 CLI-Anything 插件市场 /plugin marketplace add HKUDS/CLI-Anything ``` -**Step 2: Install the Plugin** +**第二步：安装插件** ```bash -# Install the cli-anything plugin from the marketplace +# 从市场安装 cli-anything 插件 /plugin install cli-anything ``` -That's it. The plugin is now available in your Claude Code session. +搞定。插件已经在你的 Claude Code 会话中可用了。 -> **Note for Win Users:** Claude Code runs shell commands via `bash`. On Windows, install Git for Windows (includes `bash` and -`cygpath`) or use WSL; otherwise commands may fail with `cygpath: command not found`. +**Windows 注意：** Claude Code 通过 `bash` 执行命令。Windows 下请安装 Git for Windows（包含 `bash` 和 `cygpath`） +或使用 WSL，否则可能出现 `cygpath: command not found`。 -**Step 3: Build a CLI in One Command** +**第三步：一行命令生成 CLI** ```bash -# /cli-anything -# Generate a complete CLI for GIMP (all 7 phases) +# /cli-anything <软件路径或仓库地址> +# 为 GIMP 生成完整的 CLI（7 个阶段全自动） /cli-anything ./gimp + +# 兼容写法（旧版本 Claude Code 可重试） +# /cli-anything:cli-anything ./gimp ``` -Command compatibility across Claude Code versions: -- Use `/cli-anything` as the primary entrypoint. -- On older builds where `/cli-anything` isn't recognized **after confirming the plugin is installed and loaded**, try the legacy entry form `/cli-anything:cli-anything`. -- Auxiliary commands keep the `:subcommand` form (e.g. `/cli-anything:refine`). +Claude Code 不同版本的命令兼容说明： +- 优先使用 `/cli-anything` 作为主入口。 +- 在已**确认插件已安装并加载**的情况下，若旧版本的 Claude Code 不识别 `/cli-anything`，可尝试兼容写法 `/cli-anything:cli-anything`。 +- 其他辅助命令保持 `:子命令` 形式（例如 `/cli-anything:refine`）。 -If you see `Unknown skill: cli-anything`, focus on plugin install/load first (both entry forms reference the same skill, so swapping forms won't help): -1. Reload plugin commands: `/reload-plugins` -2. Verify the plugin is loaded: `/help cli-anything` (CLI-Anything help/commands should appear) -3. Reinstall from marketplace if needed: +如果出现 `Unknown skill: cli-anything`，两种写法都引用同一个 skill 名称，切换写法无法解决，请优先排查插件是否已安装/加载： +1. 重新加载插件命令：`/reload-plugins` +2. 验证插件是否已加载：`/help cli-anything`（能看到 CLI-Anything 帮助即表示已加载） +3. 如仍未识别，重新从市场安装： - `/plugin marketplace add HKUDS/CLI-Anything` - `/plugin install cli-anything` -4. After confirming the plugin is available, retry the entry command: - - Preferred: `/cli-anything ./gimp` - - Older builds only: `/cli-anything:cli-anything ./gimp` +4. 确认插件可用后，再重试入口命令： + - 推荐：`/cli-anything ./gimp` + - 仅旧版本：`/cli-anything:cli-anything ./gimp` -This runs the full pipeline: -1. 🔍 **Analyze** — Scans source code, maps GUI actions to APIs -2. 📐 **Design** — Architects command groups, state model, output formats -3. 🔨 **Implement** — Builds Click CLI with REPL, JSON output, undo/redo -4. 📋 **Plan Tests** — Creates TEST.md with unit + E2E test plans -5. 🧪 **Write Tests** — Implements comprehensive test suite -6. 📝 **Document** — Updates TEST.md with results -7. 📦 **Publish** — Creates `setup.py`, installs to PATH +完整流水线自动执行： +1. 🔍 **分析** — 扫描源码，将 GUI 操作映射到 API +2. 📐 **设计** — 规划命令分组、状态模型、输出格式 +3. 🔨 **实现** — 构建 Click CLI，包含 REPL、JSON 输出、撤销/重做 +4. 📋 **规划测试** — 生成 TEST.md，涵盖单元测试和端到端测试计划 +5. 🧪 **编写测试** — 实现完整测试套件 +6. 📝 **文档** — 更新 TEST.md，写入测试结果 +7. 📦 **发布** — 生成 `setup.py`，安装到 PATH -**Step 4 (Optional): Refine and Improve the CLI** +**第四步（可选）：优化和扩展 CLI** -After the initial build, you can iteratively refine the CLI to expand coverage and add missing capabilities: +初始构建完成后，你可以迭代优化 CLI，扩展覆盖面并补充缺失的功能： ```bash -# Broad refinement — agent analyzes gaps across all capabilities +# 全面优化 — Agent 分析所有功能的覆盖差距 /cli-anything:refine ./gimp -# Focused refinement — target a specific functionality area -/cli-anything:refine ./gimp "I want more CLIs on image batch processing and filters" +# 定向优化 — 指定特定功能领域 +/cli-anything:refine ./gimp "我需要更多图像批处理和滤镜相关的 CLI" ``` -The refine command performs gap analysis between the software's full capabilities and current CLI coverage, then implements new commands, tests, and documentation for the identified gaps. You can run it multiple times to steadily expand coverage — each run is incremental and non-destructive. +优化命令会对软件的完整功能与当前 CLI 覆盖范围进行差距分析，然后为识别到的差距实现新命令、测试和文档。你可以多次运行该命令，逐步扩大功能覆盖范围 — 每次运行都是增量的、非破坏性的。
-Alternative: Manual Installation +备选方案：手动安装 -If you prefer not to use the marketplace: +如果你不想用插件市场： ```bash -# Clone the repo +# 克隆仓库 git clone https://github.com/HKUDS/CLI-Anything.git -# Copy plugin to Claude Code plugins directory +# 复制插件到 Claude Code 插件目录 cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything -# Reload plugins +# 重新加载插件 /reload-plugins ``` @@ -350,167 +163,84 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
-

⚡ Pi Coding Agent

 +

⚡ OpenCode （实验性支持）

 -**Step 1: Install the Extension** +**第一步：安装命令** -The extension lives at `.pi-extension/cli-anything/` in this repository. Install it globally so `/cli-anything` commands are available in **all** Pi projects: +**注意：** 请升级到最新 OpenCode，旧版本可能使用不同的命令目录路径。 + +将 CLI-Anything 命令**和** `HARNESS.md` 复制到 OpenCode 命令目录： ```bash -# Clone the repo -git clone https://github.com/HKUDS/CLI-Anything.git -cd CLI-Anything - -# Install globally into Pi's extensions directory -bash .pi-extension/cli-anything/install.sh -``` - -To uninstall: - -```bash -bash .pi-extension/cli-anything/install.sh --uninstall -``` - -> **How it works:** `install.sh` copies the extension files (including HARNESS.md, commands, guides, scripts, and templates from `cli-anything-plugin/`) into `~/.pi/agent/extensions/cli-anything/`, which Pi auto-discovers on startup. Run `/reload` in Pi or restart Pi to activate. - -**Step 2: Build a CLI in One Command** - -Once the extension is loaded, the following commands are available: - -```bash -# Generate a complete CLI for GIMP (all 7 phases) -/cli-anything ./gimp - -# Build from a GitHub repo -/cli-anything https://github.com/blender/blender -``` - -**Step 3 (Optional): Refine and Improve the CLI** - -```bash -# Broad refinement — agent analyzes gaps across all capabilities -/cli-anything:refine ./gimp - -# Focused refinement — target a specific functionality area -/cli-anything:refine ./gimp "batch processing and filters" -``` - -**Available Commands** - -| Command | Description | -|---------|-------------| -| `/cli-anything ` | Build a complete CLI harness | -| `/cli-anything:refine [focus]` | Refine an existing CLI harness | -| `/cli-anything:test ` | Run tests for a CLI harness | -| `/cli-anything:validate ` | Validate a CLI harness | -| `/cli-anything:list [options]` | List all CLI-Anything tools | - -
- -
-

⚡ OpenCode (Experimental)

 - -**Step 1: Install the Commands** - -> **Note:** Please upgrade to the latest OpenCode. Older versions may use a different commands path. - -Copy the CLI-Anything commands **and** `HARNESS.md` to your OpenCode commands directory: - -```bash -# Clone the repo +# 克隆仓库 git clone https://github.com/HKUDS/CLI-Anything.git -# Global install (available in all projects) +# 全局安装（所有项目可用） cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/ -# Or project-level install +# 或项目级安装 cp CLI-Anything/opencode-commands/*.md .opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/ ``` -> **Note:** Please upgrade to the latest OpenCode. Older versions use `command/` (singular) instead of `commands/`. If `commands/` does not exist, use `command/` for both global and project-level installs. +> **注意：** `HARNESS.md` 是所有命令引用的方法论规范，必须和命令文件放在同一目录下。 -> **Note:** `HARNESS.md` is the methodology spec that all commands reference. It must be in the same directory as the commands. +安装后获得 5 个斜杠命令：`/cli-anything`、`/cli-anything-refine`、`/cli-anything-test`、`/cli-anything-validate` 和 `/cli-anything-list`。 -This adds 5 slash commands: `/cli-anything`, `/cli-anything-refine`, `/cli-anything-test`, `/cli-anything-validate`, and `/cli-anything-list`. - -**Step 2: Build a CLI in One Command** +**第二步：一行命令生成 CLI** ```bash -# Generate a complete CLI for GIMP (all 7 phases) +# 为 GIMP 生成完整的 CLI（7 个阶段全自动） /cli-anything ./gimp -# Build from a GitHub repo +# 从 GitHub 仓库构建 /cli-anything https://github.com/blender/blender ``` -The command runs as a subtask and follows the same 7-phase methodology as Claude Code. +命令以子任务方式运行，遵循与 Claude Code 相同的 7 阶段方法论。 -**Step 3 (Optional): Refine and Improve the CLI** +**第三步（可选）：优化和扩展 CLI** ```bash -# Broad refinement — agent analyzes gaps across all capabilities +# 全面优化 — Agent 分析所有功能的覆盖差距 /cli-anything-refine ./gimp -# Focused refinement — target a specific functionality area -/cli-anything-refine ./gimp "batch processing and filters" +# 定向优化 — 指定特定功能领域 +/cli-anything-refine ./gimp "批处理和滤镜" ```
-

⚡ Goose (Desktop / CLI) Experimental Community

 -**Step 1: Install Goose** +

⚡ Qodercli 社区贡献

 -Install Goose (Desktop or CLI) using the official Goose instructions for your OS. - -**Step 2: Configure a CLI Provider** - -Configure Goose to use a CLI provider such as Claude Code, and make sure that CLI is installed and authenticated. - -**Step 3: Use CLI-Anything in a Goose Session** - -Once Goose is configured, start a session and use the same CLI-Anything commands described above for Claude Code, for example: - -```bash -/cli-anything ./gimp -/cli-anything:refine ./gimp "batch processing and filters" -``` - -> Note: When Goose runs through a CLI provider, it uses that provider's capabilities and command format. -
- -
- -

⚡ Qodercli Community

 - -**Step 1: Register the Plugin** +**第一步：注册插件** ```bash git clone https://github.com/HKUDS/CLI-Anything.git bash CLI-Anything/qoder-plugin/setup-qodercli.sh ``` -This registers the cli-anything plugin in `~/.qoder.json`. Start a new Qodercli session after registration. +脚本会将 cli-anything 插件注册到 `~/.qoder.json`。注册后开启新的 Qodercli 会话即可使用。 -**Step 2: Use CLI-Anything from Qodercli** +**第二步：在 Qodercli 中使用 CLI-Anything** ```bash -/cli-anything ./gimp -/cli-anything:refine ./gimp "batch processing and filters" +/cli-anything:cli-anything ./gimp +/cli-anything:refine ./gimp "批处理和滤镜" /cli-anything:validate ./gimp ```
-

⚡ OpenClaw Community

 +

⚡ OpenClaw

 -**Step 1: Install the Skill** +**第一步：安装 Skill** -CLI-Anything provides a native OpenClaw `SKILL.md` file. Copy it to your OpenClaw skills directory: +CLI-Anything 提供了原生的 OpenClaw `SKILL.md` 文件。请将其复制到你的 OpenClaw 技能目录： ```bash # Clone the repo @@ -521,50 +251,46 @@ mkdir -p ~/.openclaw/skills/cli-anything cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md ``` -**Step 2: Build a CLI** +**第二步：构建 CLI** -Now you can invoke the skill inside OpenClaw: +安装完成后，你就可以在 OpenClaw 中直接调用： `@cli-anything build a CLI for ./gimp` -The skill follows the same 7-phase methodology as Claude Code and OpenCode. +该技能采用了与 Claude Code 和 OpenCode 一致的 7 步构建流程。
-

⚡ Codex Experimental Community

 +

⚡ Codex 实验性 社区贡献

 -**Step 1: Install the Skill** +**第一步：安装 Skill** -Run the bundled installer: +运行仓库内置的安装脚本： ```bash -# Clone the repo +# 克隆仓库 git clone https://github.com/HKUDS/CLI-Anything.git -# Install the skill +# 安装 skill bash CLI-Anything/codex-skill/scripts/install.sh ``` -On Windows PowerShell, use: +在 Windows PowerShell 中，可以使用： ```powershell .\CLI-Anything\codex-skill\scripts\install.ps1 ``` -This installs the skill to `$CODEX_HOME/skills/cli-anything` (or `~/.codex/skills/cli-anything` if `CODEX_HOME` is unset). -The installer also vendors the canonical `HARNESS.md`, command specifications, -on-demand guides, reusable helper scripts, skill template, and preview protocol -into the installed skill's `references/` and `scripts/` directories. -This keeps the Codex skill self-contained while using `cli-anything-plugin/` as -the source of truth. +脚本会把 skill 安装到 `$CODEX_HOME/skills/cli-anything`；如果没有设置 `CODEX_HOME`，则默认安装到 `~/.codex/skills/cli-anything`。 +安装器还会把权威版本的 `HARNESS.md`、命令规范、按需指南、可复用辅助脚本、skill 模板和 preview 协议复制到已安装 skill 的 `references/` 和 `scripts/` 目录。这样 Codex skill 可以独立工作，同时仍以 `cli-anything-plugin/` 作为唯一权威来源。 -Restart Codex after installation so it is discovered. +安装后重启 Codex，让它重新发现这个 skill。 -**Step 2: Use CLI-Anything from Codex** +**第二步：在 Codex 里使用 CLI-Anything** -Describe the task in natural language, for example: +直接用自然语言描述任务，例如： ```text Use CLI-Anything to build a harness for ./gimp @@ -573,105 +299,22 @@ Use CLI-Anything to validate ./libreoffice Use CLI-Anything to list generated harnesses under the current directory ``` -The Codex skill adapts the same methodology used by the Claude Code plugin and -OpenCode commands, while keeping the generated Python harness format unchanged. +这个 Codex skill 复用了 Claude Code 插件和 OpenCode 命令所使用的同一套方法论， +不会改变生成出来的 Python harness 结构。 -To verify the self-contained Codex installation locally: +可以运行下面的命令，验证 Codex 安装包是否完整： ```bash bash CLI-Anything/codex-skill/tests/test_install.sh ``` +
-

⚡ Hermes Experimental Community

 +

⚡ GitHub Copilot CLI 社区贡献

 -**Step 1: Install the Skill** - -Run the bundled installer: - -```bash -# Clone the repo -git clone https://github.com/HKUDS/CLI-Anything.git - -# Install the skill -bash CLI-Anything/hermes-skill/scripts/install.sh -``` - -On Windows PowerShell, use: - -```powershell -.\CLI-Anything\hermes-skill\scripts\install.ps1 -``` - -This installs the skill to `$HERMES_HOME/skills/cli-anything-hermes` (or `~/.hermes/skills/cli-anything-hermes` if `HERMES_HOME` is unset). - -Restart [Hermes Agent](https://github.com/NousResearch/hermes-agent) after installation so it is discovered. - -**Step 2: Use CLI-Anything from Hermes** - -Describe the task in natural language, for example: - -```text -Use CLI-Anything to build a harness for ./gimp -Use CLI-Anything to refine ./shotcut for picture-in-picture workflows -Use CLI-Anything to validate ./libreoffice -``` - -The Hermes skill adapts the same methodology used by the Claude Code plugin and -Codex skill, binding Hermes's `terminal`, `execute_code`, `delegate_task`, and -`read_file` / `write_file` / `patch` tools to the 7-phase harness workflow while -keeping the generated Python harness format unchanged. -
- -
- -

⚡ Reasonix Experimental Community

 - -**Step 1: Install the Skill** - -Run the bundled installer: - -```bash -# Clone the repo -git clone https://github.com/HKUDS/CLI-Anything.git - -# Install the skill -bash CLI-Anything/reasonix-skill/scripts/install.sh -``` - -On Windows PowerShell, use: - -```powershell -.\CLI-Anything\reasonix-skill\scripts\install.ps1 -``` - -This installs the skill to Reasonix's global skill directory at `~/.reasonix/skills/cli-anything`. - -Restart Reasonix after installation so it is discovered. - -**Step 2: Use CLI-Anything from Reasonix** - -Describe the task in natural language, for example: - -```text -Use CLI-Anything to build a harness for ./gimp -Use CLI-Anything to refine ./shotcut for picture-in-picture workflows -Use CLI-Anything to validate ./libreoffice -``` - -The Reasonix skill adapts the same methodology used by the Claude Code plugin and -Codex/Hermes skills, binding Reasonix's `bash`, `write_file`, `edit_file`, -`multi_edit`, `grep`, `glob`, and optional `mcp__codegraph__search` / `mcp__codegraph__context` tools to the -7-phase harness workflow while keeping the generated Python harness format unchanged. -
- -
- -

⚡ GitHub Copilot CLI Community

 - -**Step 1: Install the Plugin** +**第一步：安装插件** ```bash git clone https://github.com/HKUDS/CLI-Anything.git @@ -679,146 +322,116 @@ cd CLI-Anything copilot plugin install ./cli-anything-plugin ``` -This installs the CLI-Anything plugin to GitHub Copilot CLI. The plugin should now be available in your GitHub Copilot CLI session. +这将 CLI-Anything 插件安装到 GitHub Copilot CLI 中。插件应该已经在你的 GitHub Copilot CLI 会话中可用了。 -**Step 2: Use CLI-Anything from GitHub Copilot CLI** +**第二步：在 GitHub Copilot CLI 中使用 CLI-Anything** ```bash -/cli-anything ./gimp -/cli-anything:refine ./gimp "batch processing and filters" +/cli-anything:cli-anything ./gimp +/cli-anything:refine ./gimp "批处理和滤镜" /cli-anything:validate ./gimp ```
-

🔮 More Platforms (Coming Soon)

 +

🔮 更多平台（即将支持）

 -CLI-Anything is designed to be platform-agnostic. Support for more AI coding agents is planned: +CLI-Anything 的设计是平台无关的，计划支持更多 AI 编程工具： -- **Codex** — available via the bundled skill in `codex-skill/` -- **Cursor** — coming soon -- **Windsurf** — coming soon -- **Your favorite tool** — contributions welcome! See the `opencode-commands/` directory for a reference implementation. +- **Codex** — 已通过 `codex-skill/` 提供接入 +- **Cursor** — 即将支持 +- **Windsurf** — 即将支持 +- **你喜欢的工具** — 欢迎贡献！参考 `opencode-commands/` 目录的实现。
-### Use the Generated CLI +### 开始使用生成的 CLI -Regardless of which platform you used to build it, the generated CLI works the same way: +无论你用哪个平台构建，生成的 CLI 使用方式完全一样： ```bash -# Install to PATH +# 安装到 PATH cd gimp/agent-harness && pip install -e . -# Use from anywhere +# 随处可用 cli-anything-gimp --help cli-anything-gimp project new --width 1920 --height 1080 -o poster.json cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e" -# Enter interactive REPL +# 进入交互式 REPL cli-anything-gimp ``` -Each in-repo harness now has a canonical [`SKILL.md`](#-skillmd-generation) at `skills/cli-anything-/SKILL.md`, which makes the monorepo directly discoverable via `npx skills add HKUDS/CLI-Anything --list`. Installed harness packages still ship a compatibility copy at `cli_anything//skills/SKILL.md`, and the REPL banner prefers the repo-root canonical file when present, falling back to the packaged copy otherwise. +--- -
+## 💡 CLI-Anything 的愿景：构建 Agent 原生的软件生态 + +• 🌐 **无门槛接入** - 任何软件都能通过结构化 CLI 即刻被 Agent 操控。 + +• 🔗 **无缝集成** - 不需要专门的 API、不需要操控 GUI、不需要重构代码，也不需要复杂的适配层。 + +• 🚀 **面向未来** - 一条命令，就能把为人类设计的软件变成 Agent 的原生工具。 --- -## 🤖 Empower Your Agents with CLI-Hub +## 🔧 适用场景 -CLI-Hub lets agents autonomously discover, install, and use the CLIs they need. - -```bash -npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y -``` - -**Also available on:** [ClawHub](https://clawhub.ai/yuh-yang/cli-anything-hub), [SkillHub](https://www.skillhub.club/web/skills/itsyuhao-cli-anything-hub), [SkillHub.cn](https://skillhub.cn/skills/cli-hub-meta-skill) - -Then prompt: - -```text -Find appropriate CLI software in CLI-Hub and complete the task: ... -``` - -The meta-skill points agents to the live CLI-Hub catalog, where they can choose a CLI, install it, and read its own `SKILL.md` for task-specific usage. +| 类别 | 如何接入 Agent | 典型软件 | +|------|--------------|---------| +| **📂 GitHub 开源项目** | 通过自动生成 CLI，将任意开源项目转化为 Agent 可控工具 | VSCodium、WordPress、Calibre、Zotero、Joplin、Logseq、Penpot、Super Productivity | +| **🤖 AI/ML 平台** | 用结构化命令驱动模型训练、推理流水线和超参搜索 | Stable Diffusion WebUI、ComfyUI、InvokeAI、Text-generation-webui、Open WebUI、Fooocus、Kohya_ss、AnythingLLM、SillyTavern | +| **📊 数据与分析** | 以编程方式完成数据处理、可视化和统计分析工作流 | JupyterLab、Apache Superset、Metabase、Redash、DBeaver、KNIME、Orange、OpenSearch Dashboards、Lightdash | +| **💻 开发工具** | 通过 CLI 串联代码编辑、构建、测试与部署流程 | Jenkins、Gitea、Hoppscotch、Portainer、pgAdmin、SonarQube、ArgoCD、OpenLens、Insomnia、Beekeeper Studio | +| **🎨 创意与媒体** | 以编程方式控制内容创作、编辑和渲染工作流 | Blender、GIMP、OBS Studio、Audacity、WaveTone、Krita、Kdenlive、Shotcut、Inkscape、Darktable、LMMS、Ardour | +| **📐 图表与可视化** | 以编程方式创建和操作流程图、架构图、ER 图等各类图表 | Draw.io (diagrams.net)、Mermaid、PlantUML、Excalidraw、yEd | +| **🔬 科学计算** | 自动化科研工作流、仿真模拟和复杂计算 | ImageJ、FreeCAD、QGIS、ParaView、Gephi、LibreCAD、Stellarium、KiCad、JASP、Jamovi | +| **🏢 企业与办公** | 将商业应用和生产力工具转化为 Agent 可访问的系统 | NextCloud、GitLab、Grafana、Mattermost、LibreOffice、AppFlowy、NocoDB、Odoo (Community)、Plane、ERPNext | +| **📞 通信与协作** | 通过结构化 CLI 自动化会议调度、参会人管理、录制获取和报告生成 | Zoom、Jitsi Meet、BigBlueButton、Mattermost | --- -## 💡 CLI-Anything's Vision: Building Agent-Native Software +## CLI-Anything 的核心优势 -• 🌐 **Universal Access** - Every software becomes instantly agent-controllable through structured CLI. +### Agent 与软件之间的鸿沟 -• 🔗 **Seamless Integration** - Agents control any application without APIs, GUI, rebuilding or complex wrappers. +AI Agent 推理能力很强，但操控真实专业软件的能力很弱。现有方案要么是脆弱的 GUI 自动化，要么是覆盖面有限的 API，要么是阉割了 90% 功能的重新实现。 -• 🚀 **Future-Ready Ecosystem** - Transform human-designed software into agent-native tools with one command. +**CLI-Anything 的解法**：把任何专业软件变成 Agent 原生工具，功能一个不少。 + +| **现有痛点** | **CLI-Anything 怎么解** | +|------------|----------------------| +| 🤖 "AI 用不了真正的专业工具" | 直接对接真实软件后端（Blender、LibreOffice、FFmpeg）—— 完整的专业能力，零妥协 | +| 💸 "GUI 自动化三天两头崩" | 告别截图、点击和 RPA 的脆弱性，纯命令行操控，结构化接口 | +| 📊 "Agent 需要结构化数据" | 内置 JSON 输出供 Agent 直接消费，同时保留可读格式方便调试 | +| 🔧 "定制集成太贵了" | 一个插件就能为任意代码库自动生成 CLI，经过验证的 7 阶段流水线 | +| ⚡ "原型和生产之间差十万八千里" | 1,774+ 测试用例，全部在真实软件上验证通过，覆盖 13 款主流应用 | --- -## 🔧 When to Use CLI-Anything - -| Category | How to be Agent-native | Notable Examples | -|----------|----------------------|----------| -| **📂 GitHub Repositories** | Transform any open-source project into agent-controllable tools through automatic CLI generation | VSCodium, WordPress, Calibre, Zotero, Joplin, Logseq, Penpot, Super Productivity | -| **🤖 AI/ML Platforms** | Automate model training, inference pipelines, and hyperparameter tuning through structured commands | Stable Diffusion WebUI, ComfyUI, Ollama, InvokeAI, Text-generation-webui, Open WebUI, Fooocus, Kohya_ss, AnythingLLM, SillyTavern | -| **📊 Data & Analytics** | Enable programmatic data processing, visualization, and statistical analysis workflows | JupyterLab, Apache Superset, Metabase, Redash, DBeaver, KNIME, Orange, OpenSearch Dashboards, Lightdash | -| **💻 Development Tools** | Streamline code editing, building, testing, and deployment processes via command interfaces | Jenkins, Gitea, Hoppscotch, Portainer, pgAdmin, SonarQube, ArgoCD, OpenLens, Insomnia, Beekeeper Studio, **[iTerm2](https://iterm2.com)** | -| **🎨 Creative & Media** | Control content creation, editing, and rendering workflows programmatically | Blender, GIMP, OBS Studio, Audacity, WaveTone, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour | -| **🎮 Game Development** | Manage game projects, scenes, exports, and scripting through headless engine interfaces | **[Godot Engine](https://godotengine.org)**, **[s&box](https://sbox.game)** | -| **🔬 Scientific Computing** | Automate research workflows, simulations, and complex calculations | ImageJ, FreeCAD, QGIS, ParaView, Gephi, LibreCAD, Stellarium, KiCad, JASP, Jamovi | -| **🏢 Enterprise & Office** | Convert business applications and productivity tools into agent-accessible systems | NextCloud, GitLab, Grafana, Mattermost, LibreOffice, AppFlowy, NocoDB, Odoo (Community), Plane, ERPNext | -| **📞 Communication & Collaboration** | Automate meeting scheduling, participant management, recording retrieval, and reporting through structured CLI | Zoom, Jitsi Meet, BigBlueButton, Mattermost | -| **📐 Diagramming & Visualization** | Create and manipulate diagrams, flowcharts, architecture diagrams, and visual documentation programmatically | Draw.io (diagrams.net), Mermaid, PlantUML, Excalidraw, yEd | -| **🌐 Network & Infrastructure** | Manage network services, DNS, ad-blocking, and infrastructure through structured CLI commands | AdGuardHome | -| **🧪 Testing & Mocking** | Control HTTP mock servers, manage test stubs, record and replay API traffic for integration testing | **[WireMock](https://wiremock.org)** | -| **🔬 Graphics & GPU Debugging** | Analyze GPU frame captures, inspect pipeline state, export shaders, and diff rendering state | RenderDoc | -| **🎬 Video & Subtitles** | Transcribe speech, translate subtitles, burn styled captions into video — full captioning pipeline | VideoCaptioner | -| **🔍 AI-Native Search** | Neural and deep web search with structured content retrieval through embedding-based APIs | [Exa](https://exa.ai) | -| **✨ AI Content Generation** | Generate professional deliverables (slides, docs, diagrams, websites, research reports) through AI-powered cloud APIs | [AnyGen](https://www.anygen.io), Gamma, Beautiful.ai, Tome | - ---- - -## CLI-Anything's Key Features - -### The Agent-Software Gap -AI agents are great at reasoning but terrible at using real professional software. Current solutions are fragile UI automation, limited APIs, or dumbed-down reimplementations that miss 90% of functionality. - -**CLI-Anything's Solution**: Transform any professional software into agent-native tools without losing capabilities. - -| **Current Pain Point** | **CLI-Anything's Fix** | -|----------|----------------------| -| 🤖 "AI can't use real tools" | Direct integration with actual software backends (Blender, LibreOffice, FFmpeg) — full professional capabilities, zero compromises | -| 💸 "UI automation breaks constantly" | No screenshots, no clicking, no RPA fragility. Pure command-line reliability with structured interfaces | -| 📊 "Agents need structured data" | Built-in JSON output for seamless agent consumption + human-readable formats for debugging | -| 🔧 "Custom integrations are expensive" | One Claude plugin auto-generates CLIs for ANY codebase through proven 7-phase pipeline | -| ⚡ "Prototype vs Production gap" | 2,280+ tests with real software validation. Battle-tested across 18 major applications | - ---- - -## 🎯 What Can You Do with CLI-Anything? +## 🎯 CLI-Anything 能做什么？ @@ -826,526 +439,254 @@ CLI-Anything can flat-out **replace GUI-based agent approaches** — no more scr --- -## ✨ ⚙️ How CLI-Anything Works +## ✨ ⚙️ CLI-Anything 的工作方式
-### 🛠️ Let Agents Take Your Workflows +### 🛠️ 让 Agent 接管你的工作流 -Professional or everyday — just throw the codebase at `/cli-anything`. GIMP, Blender, Shotcut for creative work. LibreOffice, OBS Studio for daily tasks. Don't have the source? Find an open-source alternative and throw *that* in. You'll instantly get a full CLI your agents can use. +不管是专业场景还是日常事务 —— 把代码库扔给 `/cli-anything` 就行。GIMP、Blender、Shotcut 搞创作，LibreOffice、OBS Studio 干日常。没有源码？找个开源替代品，照样能用。你会立刻得到一套 Agent 可以直接调用的完整 CLI。 -### 🔗 Unify Scattered APIs into One CLI +### 🔗 把散装 API 统一成一个 CLI -Tired of juggling fragmented web service APIs? Feed the docs or SDK manuscripts to `/cli-anything` and your agents get a **powerful, stateful CLI** that wraps those individual endpoints into coherent command groups. One tool instead of dozens of raw API calls — stronger capabilities while saving tokens. +受够了一堆零碎的 Web 服务 API？把文档或 SDK 手册喂给 `/cli-anything`，你的 Agent 就能拿到一个**有状态的、功能完整的 CLI**，把那些零散的接口整合成逻辑清晰的命令组。一个工具可替代几十个裸 API 调用 —— 能力更强，token 更省。 -### 🚀 Replace or Supercharge GUI Agents +### 🚀 取代 GUI Agent，或让它更强 -CLI-Anything can flat-out **replace GUI-based agent approaches** — no more screenshots, no brittle pixel-clicking. But here's the fun part: once you `/cli-anything` a GUI software, you can **synthesize agent tasks, evaluators, and benchmarks** entirely via code and terminal — fully automated, iteratively refinable, massively more efficient. +CLI-Anything 可直接**替代基于 GUI 的 Agent 方案** —— 无需截图，也无需繁琐地点击像素操作。更实用的是：只要你对 GUI 软件执行过 `/cli-anything` 命令，就能**全自动生成 Agent 任务、评测器及 Benchmark** —— 全程采用纯代码与终端操作，支持迭代优化，显著提升效率。
-### 🏗️ Fully Automated 7-Phase Pipeline -From codebase analysis to PyPI publishing — the plugin handles architecture design, implementation, test planning, test writing, and documentation completely automatically. +### 🏗️ 全自动 7 阶段流水线 + +从代码分析到发布上线 —— 插件自动完成架构设计、代码实现、测试规划、测试编写和文档生成，全程无需人工介入。 -### 🎯 Authentic Software Integration -Direct calls to real applications for actual rendering. LibreOffice generates PDFs, Blender renders 3D scenes, Audacity processes audio via sox. **Zero compromises**, **Zero toy implementations**. +### 🎯 真实软件集成 + +直接调用真实应用进行渲染。LibreOffice 生成 PDF，Blender 渲染 3D 场景，Audacity 通过 sox 处理音频。**零妥协**，**零玩具实现**。
-### 🔁 Smart Session Management -Persistent project state with undo/redo capabilities, plus unified REPL interface (ReplSkin) that delivers consistent interactive experience across all CLIs. +### 🔁 智能会话管理 + +持久化项目状态，支持撤销/重做，加上统一的 REPL 交互界面（ReplSkin），所有 CLI 的使用体验保持一致。 -### 📦 Zero-Config Installation -Simple pip install -e . puts cli-anything- directly on PATH. Agents discover tools via standard which commands. No setup, no wrappers. +### 📦 零配置安装 + +`pip install -e .` 即可将 cli-anything-<软件名> 装到 PATH。Agent 通过标准的 `which` 命令发现工具，不需要额外配置。
-### 🧪 Production-Grade Testing -Multi-layered validation: unit tests with synthetic data, end-to-end tests with real files and software, plus CLI subprocess verification of installed commands. +### 🧪 生产级测试 + +多层验证：使用合成数据的单元测试、使用真实文件和软件的端到端测试，外加已安装命令的 CLI 子进程验证。 -### 🐍 Clean Package Architecture -All CLIs organized under cli_anything.* namespace — conflict-free, pip-installable, with consistent naming: cli-anything-gimp, cli-anything-blender, etc. +### 🐍 干净的包架构 + +所有 CLI 统一在 cli_anything.* 命名空间下 —— 无冲突、可 pip 安装、命名规范统一：cli-anything-gimp、cli-anything-blender 等。
-### 🤖 SKILL.md Generation - -Each generated CLI now has a canonical `SKILL.md` at `skills/cli-anything-/SKILL.md`. This makes the current monorepo directly consumable by `npx skills`, while a packaged compatibility copy at `cli_anything//skills/SKILL.md` preserves installed-harness behavior. - -**What SKILL.md provides:** -- **YAML frontmatter** with name and description for agent skill discovery -- **Command groups** with all available subcommands documented -- **Usage examples** for common workflows -- **Agent-specific guidance** for JSON output, error handling, and programmatic use - -SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_generator.py`, which extracts metadata directly from the CLI's Click decorators, setup.py, and README. The generator now writes the canonical repo-root skill file and refreshes the package-local compatibility copy used by installed harnesses. Inside this repo, the REPL banner points agents to the canonical root skill path; after `pip install`, it falls back to the packaged copy. - --- -## 🎬 Real-World Demos +## 🎬 实测展示 -AI agents using generated CLIs to produce complete, useful artifacts — no GUI needed. +### 🎯 通用性 -### FreeCAD — Curiosity Rover via Preview, Live Preview, and Trajectory +CLI-Anything 适用于任何有代码库的软件 —— 不限领域，不限架构。 -> **Harness:** `cli-anything-freecad` | **Preview Stack:** `preview` + `preview live` + `trajectory.json` | **Artifact:** Agent-built Curiosity-style rover +### 🏭 专业级测试 -An agent incrementally assembles a Curiosity-inspired rover while publishing real FreeCAD preview bundles, refreshing a live preview session, and recording command-to-preview history for later replay. The resulting demo shows the artifact evolving step by step before the final showcase. +在 13 款复杂应用上进行了实测，涵盖创意、生产力、通信、图表、原生调试、GPU 分析和 AI 内容生成领域 —— 这些软件此前对 AI Agent 来说几乎不可触及。 -

- FreeCAD Curiosity rover demo driven by preview, live preview, and trajectory history -

+### 🎨 覆盖多元领域 -

- README GIF generated from the full local demo video with a speed-adjusted, high-quality ffmpeg palette workflow. -

+从创意工作流（图像编辑、3D 建模、矢量图形）到生产工具（音频、办公、直播、视频剪辑）。 -### Blender — Orbital Relay Drone via Preview, Live Preview, and Trajectory +### ✅ 完整的 CLI 生成 -> **Harness:** `cli-anything-blender` | **Preview Stack:** `preview` + `preview live` + `trajectory.json` | **Artifact:** Agent-built orbital relay drone - -An agent uses the Blender harness to grow a hard-surface orbital relay drone under a real preview loop: each stage pushes new render-backed bundles, the live session tracks the current head, and the trajectory ties every command to the matching visual state. The demo finishes with the completed scene ready for a polished turntable. - -

- Blender orbital relay drone demo driven by preview, live preview, and trajectory history -

- -

- README GIF generated from the full local demo video with a speed-adjusted, high-quality ffmpeg palette workflow. -

- -### Draw.io — HTTPS Handshake Diagram - -> **Harness:** `cli-anything-drawio` | **Time:** ~4 min | **Artifact:** `.drawio` + `.png` - -An agent creates a full HTTPS connection lifecycle diagram from scratch — TCP three-way handshake, TLS negotiation, encrypted data exchange, and TCP four-way termination — entirely through CLI commands. - -

- Draw.io CLI demo: building an HTTPS handshake diagram -

- -
-Final artifact -

- HTTPS handshake sequence diagram -

-
- -*Contributed by [@zhangxilong-43](https://github.com/zhangxilong-43)* - -### Slay the Spire II — Game Automation - -> **Harness:** `cli-anything-slay-the-spire-ii` | **Artifact:** Automated gameplay session - -An agent plays through a Slay the Spire II run using the CLI harness — reading game state, selecting cards, choosing paths, and making strategic decisions in real-time. - -

- Slay the Spire II CLI gameplay demo -

- -*Contributed by [@TianyuFan0504](https://github.com/TianyuFan0504)* - -### VideoCaptioner — Auto-Generated Subtitles - -> **Harness:** `cli-anything-videocaptioner` | **Artifact:** Captioned video frames - -An agent uses the VideoCaptioner CLI to automatically generate and overlay styled subtitles onto video content, with bilingual text rendering and customizable formatting. - - - - - - - - - - -
Sub ASub B
Video frame before captioningVideo frame after captioning
- -*Contributed by [@WEIFENG2333](https://github.com/WEIFENG2333)* - -### ArcGIS Pro — Live Agent Cartography via the MCP Bridge - -> **Harness:** [`arcgis-pro`](https://github.com/Jasper0122/CLI-Anything-Arcgis-Pro) (registered in [`public_registry.json`](public_registry.json)) | **Mode:** live-Pro MCP bridge | **Artifact:** Agent-driven map navigation in a running ArcGIS Pro session - -An agent drives a **live, open ArcGIS Pro session** through an MCP bridge — reading the project, zooming the map to feature layers, running geoprocessing, and exporting layouts — while each step executes inside Pro as you watch. ArcGIS Pro is Esri's commercial GIS desktop (Windows-only, licensed), so this wraps its official **ArcPy / ArcGIS Pro SDK** rather than being generated from source — the ArcGIS Pro counterpart to the QGIS harness. - -

- ArcGIS Pro live-bridge demo: an agent driving a running ArcGIS Pro session over MCP -

- -

- README GIF generated from the full local demo video with a high-quality ffmpeg palette workflow. -

- -*Contributed by [@Jasper0122](https://github.com/Jasper0122)* - -*More CLI demos coming soon.* - ---- - -## 🎬 Demonstrations - -### 🎯 General-Purpose -CLI-Anything works on any software with a codebase — no domain restrictions or architectural limitations. - -### 🏭 Professional-Grade Testing -Tested across 18 diverse, complex applications spanning creative, productivity, communication, diagramming, AI image generation, AI content generation, network ad blocking, local LLM inference, native debugging, and graphics profiling domains previously inaccessible to AI agents. - -### 🎨 Diverse Domain Coverage -From creative workflows (image editing, 3D modeling, vector graphics) to production tools (audio, office, live streaming, video editing). - -### ✅ Full CLI Generation -Each application received complete, production-ready CLI interfaces — not demos, but comprehensive tool access preserving full capabilities. +每款软件都生成了完整的、可投产的 CLI 接口 —— 不是 demo，而是保留全部功能的完整工具接入。 - - - - - + + + + + - + - + - + - + - + - - - - - - - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - + - + - - - - - - - - + - + - + - + - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - + - - - - - - - - + - + - - - - - + + + + + - - - - - + + + + + - + - + - - - - - + + + + + - - + +
SoftwareDomainCLI CommandBackendTests软件领域CLI 命令后端测试
🎨 GIMPImage Editing图像编辑 cli-anything-gimp Pillow + GEGL/Script-Fu ✅ 107
🧊 Blender3D Modeling & Rendering3D 建模与渲染 cli-anything-blender bpy (Python scripting) ✅ 208
✏️ InkscapeVector Graphics矢量图形 cli-anything-inkscape Direct SVG/XML manipulation ✅ 202
🎵 AudacityAudio Production音频制作 cli-anything-audacity Python wave + sox ✅ 161
WaveToneAudio Transcription音频扒谱辅助 cli-anything-wavetone JSON manifest + real WaveTone launchNew
🌐 BrowserBrowser Automationcli-anything-browserDOMShell MCP + Accessibility Tree✅ New
Web Yu-priJapan Post Shipping Labelscli-anything-web-yu-priPlaywright + Web Yu-pri forms✅ New新增
📄 LibreOfficeOffice Suite (Writer, Calc, Impress)办公套件（Writer、Calc、Impress） cli-anything-libreoffice ODF generation + headless LO ✅ 158
OpenRefineData Cleaningcli-anything-openrefineOpenRefine local HTTP API✅ 76
⚡ n8nWorkflow Automationcli-anything-n8nn8n REST API v1.1.1✅ 55+ cmds
📧 MailchimpEmail Marketing & Automationcli-anything-mailchimpMailchimp Marketing API v3.0✅ 303 cmds
📚 ZoteroReference Management文献管理与引用 cli-anything-zotero Local SQLite + connector + Local API✅ New
📖 CalibreE-book Library Managementcli-anything-calibrecalibredb + ebook-convert + ebook-meta✅ 58
📓 JoplinNote-taking & To-doscli-anything-joplinJoplin terminal CLI subprocess✅ 134
📝 MubuKnowledge Management & Outliningcli-anything-mubuLocal Mubu data + sync logs✅ 96✅ 新增
📹 OBS StudioLive Streaming & Recording直播与录制 cli-anything-obs-studio JSON scene + obs-websocket ✅ 153
📱 NSLoggeriOS/macOS Log Capturecli-anything-nsloggerNSLogger wire protocol + native macOS Bonjour✅ 139
🎞️ KdenliveVideo Editing视频剪辑 cli-anything-kdenlive MLT XML + melt renderer ✅ 155
🎬 ShotcutVideo Editing视频剪辑 cli-anything-shotcut Direct MLT XML + melt ✅ 154
🎬 OpenscreenScreen Recording Editor屏幕录像编辑器 cli-anything-openscreen ffmpeg backend ✅ 101
📞 ZoomVideo Conferencing视频会议 cli-anything-zoom Zoom REST API (OAuth2) ✅ 22
🎵 MuseScoreMusic Notationcli-anything-musescoremscore CLI (MSCX/MusicXML)✅ 56
📐 Draw.ioDiagramming图表绘制 cli-anything-drawio mxGraph XML + draw.io CLI ✅ 138
EEZ StudioEmbedded UI / Instrument Automationcli-anything-eez-studio.eez-project JSON + EEZ Studio Node backend✅ New
⛓️ ETH2 QuickStartDevOps / Ethereumcli-anything-eth2-quickstarteth2-quickstart shell automation + JSON health checks✅ 18
🧜 Mermaid Live EditorDiagrammingcli-anything-mermaidMermaid state + mermaid.ink renderer✅ 10
✨ AnyGenAI Content GenerationAI 内容生成 cli-anything-anygen AnyGen REST API (anygen.io) ✅ 50
🧠 NotebookLMAI Research Assistantcli-anything-notebooklmNotebookLM CLI wrapper (experimental)✅ 21
🧩 Dify WorkflowDify DSL Editingcli-anything-dify-workflowWrapper around the open-source dify-workflow CLI✅ 11
🖼️ ComfyUIAI Image Generationcli-anything-comfyuiComfyUI REST API✅ 70
🛡️ AdGuard HomeNetwork-wide Ad Blockingcli-anything-adguardhomeAdGuard Home REST API✅ 36
🦙 OllamaLocal LLM Inferencecli-anything-ollamaOllama REST API✅ 98
🧬 Uni-Mol ToolsMolecular Property Prediction (AI4S)cli-anything-unimol-toolsUni-Mol molecular ML backend✅ 67
🎬 VideoCaptionerAI Video Captioningcli-anything-videocaptionervideocaptioner CLI (PyPI)✅ 26
🎨 SketchUI Designsketch-clisketch-constructor (Node.js)✅ 19
🎮 Godot EngineGame Developmentcli-anything-godotGodot 4.x headless subprocess✅ 24
📦 s&boxGame Developmentcli-anything-sboxSource 2 game engine - direct file I/O on .scene/.prefab/.vmat/.vsnd JSON✅ 244
🐞 LLDBNative Debugging原生调试 cli-anything-lldb LLDB Python API ✅ 27
🟩 Nsight Graphics CLIGPU Debugging & ProfilingGPU 调试与分析 cli-anything-nsight-graphicsOfficial ngfx / ngfx-capture orchestration + GPU Trace summary + replay analysis官方 ngfx / ngfx-capture 编排 + GPU Trace 摘要 + replay 分析 ✅ 51
🔍 ExaAI-Native Web Searchcli-anything-exaexa-py SDK✅ 40
📈 Unreal InsightsPerformance Profiling性能分析 cli-anything-unrealinsightsBackground trace sessions + engine-matched UnrealInsights build + headless export后台 trace 会话 + 匹配版 UnrealInsights 构建 + 无头导出 ✅ 50
☁️ CloudAnalyzerPoint cloud / trajectory QAcli-anything-cloudanalyzerCloudAnalyzer (Python API)✅ 14📦 s&box游戏开发cli-anything-sboxSource 2 游戏引擎 - 直接读写 .scene/.prefab/.vmat/.vsnd JSON✅ 244
🗺️ QGISGeospatial Analysis & Mappingcli-anything-qgisPyQGIS + qgis_process✅ 22🎨 SketchUI 设计sketch-clisketch-constructor (Node.js)✅ 19
🔩 3MFMesh geometry editor for 3D printing3D 打印网格编辑器 cli-anything-3mf numpy, scipy, trimesh✅ 50✅ 50+
🗄️ TigrisObject Storage (S3-compatible, global, no egress) — buckets, objects, snapshots, IAM, access keyscli-anything-tigrissubprocess wrapping the official tigris CLI✅ New📓 Joplin笔记与待办cli-anything-joplinJoplin 终端 CLI 子进程✅ 134
Total✅ 2,461合计✅ 1,955
-> **100% pass rate** across all 2,461 tests — 1,732 unit tests + 579 end-to-end tests + 19 Node.js tests. +> 全部 1,955 项测试 **100% 通过** - 1,318 项单元测试 + 487 项端到端测试 + 19 项 Node.js 测试。 --- -## 📊 Test Results +## 📊 测试结果 -Each CLI harness undergoes rigorous multi-layered testing to ensure production reliability: +每个 CLI 都经过多层严格测试，确保生产可用： -| Layer | What it tests | Example | -|-------|---------------|---------| -| **Unit tests** | Every core function in isolation with synthetic data | `test_core.py` — project creation, layer ops, filter params | -| **E2E tests (native)** | Project file generation pipeline | Valid ODF ZIP structure, correct MLT XML, SVG well-formedness | -| **E2E tests (true backend)** | Real software invocation + output verification | LibreOffice → PDF with `%PDF-` magic bytes, Blender → rendered PNG | -| **CLI subprocess tests** | Installed command via `subprocess.run` | `cli-anything-gimp --json project new` → valid JSON output | +| 测试层级 | 测什么 | 示例 | +|---------|-------|------| +| **单元测试** | 每个核心函数的隔离验证，使用合成数据 | `test_core.py` — 项目创建、图层操作、滤镜参数 | +| **端到端测试（原生）** | 项目文件的完整生成流程 | ODF ZIP 结构合法性、MLT XML 正确性、SVG 格式完整性 | +| **端到端测试（真实后端）** | 调用真实软件并验证输出 | LibreOffice → 含 `%PDF-` 魔术字节的 PDF，Blender → 渲染后的 PNG | +| **CLI 子进程测试** | 通过 `subprocess.run` 调用已安装命令 | `cli-anything-gimp --json project new` → 合法 JSON 输出 | ``` ================================ Test Summary ================================ @@ -1353,191 +694,161 @@ gimp 107 passed ✅ (64 unit + 43 e2e) blender 208 passed ✅ (150 unit + 58 e2e) inkscape 202 passed ✅ (148 unit + 54 e2e) audacity 161 passed ✅ (107 unit + 54 e2e) -wavetone 30 passed ✅ (24 unit + 6 default e2e, 2 backend-gated e2e skipped; 32 passed opt-in) +wavetone 30 passed ✅ (24 unit + 6 default e2e，2 backend-gated e2e skipped；32 passed opt-in) libreoffice 158 passed ✅ (89 unit + 69 e2e) -mubu 96 passed ✅ (85 unit + 11 e2e) obs-studio 153 passed ✅ (116 unit + 37 e2e) -nslogger 139 passed ✅ (97 unit + 42 e2e) kdenlive 155 passed ✅ (111 unit + 44 e2e) shotcut 154 passed ✅ (110 unit + 44 e2e) +openscreen 101 passed ✅ (78 unit + 23 e2e) zoom 22 passed ✅ (22 unit + 0 e2e) drawio 138 passed ✅ (116 unit + 22 e2e) -eth2-quickstart 18 passed ✅ (18 unit + 3 e2e skipped) -mermaid 10 passed ✅ (5 unit + 5 e2e) anygen 50 passed ✅ (40 unit + 10 e2e) -notebooklm 21 passed ✅ (21 unit + 0 e2e) -comfyui 70 passed ✅ (60 unit + 10 e2e) -adguardhome 36 passed ✅ (24 unit + 12 e2e) -ollama 98 passed ✅ (87 unit + 11 e2e) -sketch 19 passed ✅ (19 jest, Node.js) -renderdoc 59 passed ✅ (45 unit + 14 e2e) -cloudcompare 88 passed ✅ (49 unit + 39 e2e) -openscreen 101 passed ✅ (78 unit + 23 e2e) lldb 27 passed ✅ (23 unit + 4 e2e) nsight-graphics 51 passed ✅ (46 unit/CLI + 5 local e2e) unrealinsights 50 passed ✅ (49 unit + 1 e2e, 9 backend-gated e2e skipped) -cloudanalyzer 14 passed ✅ (7 unit + 7 e2e) +sketch 19 passed ✅ (19 jest, Node.js) 3mf 50 passed ✅ (50 unit) joplin 134 passed ✅ (107 unit + 27 e2e, 1 skipped on Windows) ────────────────────────────────────────────────────────────────────────────── -TOTAL 2,461 passed ✅ 100% pass rate +TOTAL 1,955 passed ✅ 100% pass rate ``` --- -## 🏗️ CLI-Anything's Architecture +## 🏗️ CLI-Anything 的架构

CLI-Anything Architecture

-### 🎯 Core Design Principles +### 🎯 核心设计原则 -1. **Authentic Software Integration** — The CLI generates valid project files (ODF, MLT XML, SVG) and delegates to real applications for rendering. **We build structured interfaces TO software, not replacements**. - -2. **Flexible Interaction Models** — Every CLI operates in dual modes: stateful REPL for interactive agent sessions + subcommand interface for scripting/pipelines. **Run bare command → enter REPL mode**. - -3. **Consistent User Experience** — All generated CLIs share unified REPL interface (repl_skin.py) with branded banners, styled prompts, command history, progress indicators, and standardized formatting. - -4. **Agent-Native Design** — Built-in --json flag on every command delivers structured data for machine consumption, while human-readable tables serve interactive use. **Agents discover capabilities via standard --help and which commands**. - -5. **Zero Compromise Dependencies** — Real software is a hard requirement — no fallbacks, no graceful degradation. **Tests fail (not skip) when backends are missing, ensuring authentic functionality**. +1. **真实软件集成** — CLI 生成合法的项目文件（ODF、MLT XML、SVG），然后交给真实应用去渲染。**我们做的是软件的结构化接口，而不是替代品**。 +2. **灵活的交互模式** — 每个 CLI 都支持两种模式：有状态的 REPL 用于 Agent 交互会话，子命令模式用于脚本和流水线。**直接运行命令即进入 REPL**。 +3. **一致的使用体验** — 所有生成的 CLI 共享统一的 REPL 界面（repl_skin.py），带有品牌横幅、风格化提示符、命令历史、进度指示器和标准化格式。 +4. **Agent 原生设计** — 每个命令内置 `--json` 参数，输出结构化数据供 Agent 消费，同时可读的表格格式服务于交互调试。**Agent 通过标准的 `--help` 和 `which` 命令发现能力**。 +5. **零妥协的依赖策略** — 真实软件是硬性要求 —— 没有兜底，没有降级。**后端缺失时测试直接失败（而非跳过），确保功能的真实性**。 --- -## 📂 Project Structure +## 📂 项目结构 ``` cli-anything/ -├── 📄 README.md # You are here -├── 📁 assets/ # Images and media -│ ├── icon.png # Project icon -│ └── teaser.png # Teaser figure +├── 📄 README.md # 英文文档 +├── 📄 README_CN.md # 中文文档（你在这里） +├── 📁 assets/ # 图片和媒体文件 +│ ├── icon.png # 项目图标 +│ └── teaser.png # 概览图 │ -├── 🔌 cli-anything-plugin/ # The Claude Code plugin -│ ├── HARNESS.md # Methodology SOP (source of truth) -│ ├── README.md # Plugin documentation -│ ├── QUICKSTART.md # 5-minute getting started -│ ├── PUBLISHING.md # Distribution guide -│ ├── repl_skin.py # Unified REPL interface -│ ├── commands/ # Plugin command definitions -│ │ ├── cli-anything.md # Main build command -│ │ ├── refine.md # Expand existing harness coverage -│ │ ├── test.md # Test runner -│ │ └── validate.md # Standards validation +├── 🔌 cli-anything-plugin/ # Claude Code 插件 +│ ├── HARNESS.md # 方法论 SOP（唯一权威来源） +│ ├── README.md # 插件文档 +│ ├── QUICKSTART.md # 5 分钟快速上手 +│ ├── PUBLISHING.md # 分发与发布指南 +│ ├── repl_skin.py # 统一 REPL 界面 +│ ├── commands/ # 插件命令定义 +│ │ ├── cli-anything.md # 主构建命令 +│ │ ├── refine.md # 扩展已有 harness 覆盖面 +│ │ ├── test.md # 测试运行器 +│ │ ├── validate.md # 标准验证 +│ │ └── list.md # 列出所有 CLI 工具 │ └── scripts/ -│ └── setup-cli-anything.sh # Setup script +│ └── setup-cli-anything.sh # 安装脚本 │ -├── 🤖 codex-skill/ # Self-contained Codex skill installer -│ ├── SKILL.md # Codex workflow entry point -│ ├── agents/ # Codex UI metadata -│ ├── scripts/ # Bash and PowerShell installers -│ └── tests/ # Installer resource-sync regression test -├── 🧭 hermes-skill/ # Hermes Agent skill entry point -├── 🧠 reasonix-skill/ # Reasonix skill entry point -├── 🎨 gimp/agent-harness/ # GIMP CLI (107 tests) -├── 🧊 blender/agent-harness/ # Blender CLI (208 tests) -├── ✏️ inkscape/agent-harness/ # Inkscape CLI (202 tests) -├── 🎵 audacity/agent-harness/ # Audacity CLI (161 tests) -├── wavetone/agent-harness/ # WaveTone CLI (32 tests: 30 default + 2 backend-gated e2e) -├── 🌐 browser/agent-harness/ # Browser CLI (DOMShell MCP, new) -├── 🌐 web-yu-pri/agent-harness/ # Japan Post Web Yu-pri CLI (new) -├── 📄 libreoffice/agent-harness/ # LibreOffice CLI (158 tests) -├── 🧹 openrefine/agent-harness/ # OpenRefine CLI (76 tests: 64 unit + 12 real backend e2e) -├── 📧 mailchimp/agent-harness/ # Mailchimp Marketing API CLI (303 commands, 36 unit tests) -├── 📚 zotero/agent-harness/ # Zotero CLI (new, write import support) -├── 📖 calibre/agent-harness/ # Calibre CLI (58 tests: 38 unit + 20 E2E) -├── 📓 joplin/agent-harness/ # Joplin CLI (134 tests: 107 unit + 27 e2e) -├── 📝 mubu/agent-harness/ # Mubu CLI (96 tests) -├── 📹 obs-studio/agent-harness/ # OBS Studio CLI (153 tests) -├── 📱 nslogger/agent-harness/ # NSLogger CLI (139 tests) -├── 🎞️ kdenlive/agent-harness/ # Kdenlive CLI (155 tests) -├── 🎬 shotcut/agent-harness/ # Shotcut CLI (154 tests) -├── 📞 zoom/agent-harness/ # Zoom CLI (22 tests) -├── 🎵 musescore/agent-harness/ # MuseScore CLI (56 tests) -├── 📐 drawio/agent-harness/ # Draw.io CLI (138 tests) -├── 🧪 eez-studio/agent-harness/ # EEZ Studio CLI (project, LVGL, SCPI automation) -├── ⛓️ eth2-quickstart/agent-harness/ # ETH2 QuickStart CLI (18 unit, 3 e2e skipped) -├── 🧜 mermaid/agent-harness/ # Mermaid Live Editor CLI (10 tests) -├── ✨ anygen/agent-harness/ # AnyGen CLI (50 tests) -├── 🖼️ comfyui/agent-harness/ # ComfyUI CLI (70 tests) -├── 🧠 notebooklm/agent-harness/ # NotebookLM CLI (experimental, 21 tests) -├── 🧩 dify-workflow/agent-harness/ # Dify Workflow CLI wrapper (11 tests) -├── 🛡️ adguardhome/agent-harness/ # AdGuard Home CLI (36 tests) -├── 🦙 ollama/agent-harness/ # Ollama CLI (98 tests) -├── 🎮 godot/agent-harness/ # Godot Engine CLI (24 tests) -├── 📦 sbox/agent-harness/ # s&box CLI (244 tests: 157 unit + 17 orchestrator + 50 e2e + 20 exit-code) -├── 🎨 sketch/agent-harness/ # Sketch CLI (19 tests, Node.js) -├── 🔬 renderdoc/agent-harness/ # RenderDoc CLI (59 tests) -├── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI (51 tests) -├── 🐞 lldb/agent-harness/ # LLDB CLI (27 tests) -├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI (50 tests) -├── 🎬 videocaptioner/agent-harness/ # VideoCaptioner CLI (26 tests) -├── 🎬 openscreen/agent-harness/ # Openscreen CLI — screen recording editor (101 tests) -├── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests) -├── 🔍 exa/agent-harness/ # Exa CLI (40 tests) -└── ⛅ cloudanalyzer/agent-harness/ # CloudAnalyzer CLI (14 tests) -└── 🔩 3MF/agent-harness/ # 3MF Mesh Editor CLI (50+ tests) +├── 📋 opencode-commands/ # OpenCode 命令 +│ ├── cli-anything.md # 主构建命令 +│ ├── cli-anything-refine.md # 优化扩展命令 +│ ├── cli-anything-test.md # 测试运行器 +│ ├── cli-anything-validate.md # 标准验证 +│ └── cli-anything-list.md # 列出所有 CLI 工具 +│ +├── 🤖 codex-skill/ # 可独立安装的 Codex skill +│ ├── SKILL.md # Codex 工作流入口 +│ ├── agents/ # Codex 界面元数据 +│ ├── scripts/ # Bash 和 PowerShell 安装器 +│ └── tests/ # 安装资源同步回归测试 +├── 🎨 gimp/agent-harness/ # GIMP CLI（107 项测试） +├── 🧊 blender/agent-harness/ # Blender CLI（208 项测试） +├── ✏️ inkscape/agent-harness/ # Inkscape CLI（202 项测试） +├── 🎵 audacity/agent-harness/ # Audacity CLI（161 项测试） +├── wavetone/agent-harness/ # WaveTone CLI（32 项测试：30 default + 2 backend-gated e2e） +├── 📄 libreoffice/agent-harness/ # LibreOffice CLI（158 项测试） +├── 📚 zotero/agent-harness/ # Zotero CLI（新增，支持文献导入） +├── 📓 joplin/agent-harness/ # Joplin CLI（134 测试：107 单元 + 27 e2e） +├── 📹 obs-studio/agent-harness/ # OBS Studio CLI（153 项测试） +├── 🎞️ kdenlive/agent-harness/ # Kdenlive CLI（155 项测试） +├── 🎬 shotcut/agent-harness/ # Shotcut CLI（154 项测试） +├── 🎬 openscreen/agent-harness/ # Openscreen CLI — 屏幕录像编辑器（101 项测试） +├── 📞 zoom/agent-harness/ # Zoom CLI（22 项测试） +├── 📐 drawio/agent-harness/ # Draw.io CLI（138 项测试） +├── ✨ anygen/agent-harness/ # AnyGen CLI（50 项测试） +├── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI（51 项测试） +├── 🐞 lldb/agent-harness/ # LLDB CLI（27 项测试） +├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI（50 项测试） +├── 📦 sbox/agent-harness/ # s&box CLI（244 项测试: 157 单元 + 17 orchestrator + 50 e2e + 20 exit-code） +└── 🎨 sketch/agent-harness/ # Sketch CLI（19 项测试，Node.js） ``` -Each `agent-harness/` contains an installable Python package under `cli_anything./` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests. +每个 `agent-harness/` 包含一个可安装的 Python 包，位于 `cli_anything.<软件名>/` 下，包含 Click CLI、核心模块、工具类（含 `repl_skin.py` 和后端适配器）以及完整的测试。 --- -## 🎯 Plugin Commands +## 🎯 插件命令 -| Command | Description | -|---------|-------------| -| `/cli-anything ` | Build complete CLI harness — all 7 phases | -| `/cli-anything:refine [focus]` | Refine an existing harness — expand coverage with gap analysis | -| `/cli-anything:test ` | Run tests and update TEST.md with results | -| `/cli-anything:validate ` | Validate against HARNESS.md standards | +| 命令 | 说明 | +|-----|------| +| `/cli-anything <软件路径或仓库>` | 构建完整的 CLI —— 全部 7 个阶段 | +| `/cli-anything:refine <软件路径> [聚焦方向]` | 优化已有的 CLI —— 通过差距分析扩展覆盖面 | +| `/cli-anything:test <软件路径或仓库>` | 运行测试并更新 TEST.md | +| `/cli-anything:validate <软件路径或仓库>` | 按照 HARNESS.md 标准进行验证 | +| `/cli-anything:list` | 列出所有已安装和已生成的 CLI 工具 | -### Examples +### 使用示例 ```bash -# Build a complete CLI for GIMP from local source +# 从本地源码为 GIMP 构建完整 CLI /cli-anything /home/user/gimp -# Build from a GitHub repo +# 从 GitHub 仓库构建 /cli-anything https://github.com/blender/blender -# Refine an existing harness — broad gap analysis +# 优化已有的 CLI —— 全面差距分析 /cli-anything:refine /home/user/gimp -# Refine with a specific focus area -/cli-anything:refine /home/user/shotcut "vid-in-vid and picture-in-picture compositing" +# 带聚焦方向的优化 +/cli-anything:refine /home/user/shotcut "画中画和视频叠加合成" -# Run tests and update TEST.md +# 运行测试并更新 TEST.md /cli-anything:test /home/user/inkscape -# Validate against HARNESS.md standards +# 按照 HARNESS.md 标准验证 /cli-anything:validate /home/user/audacity ``` --- -## 🎮 Demo: Using a Generated CLI +## 🎮 实际操作演示 -Here's what an agent can do with `cli-anything-libreoffice`: +以 `cli-anything-libreoffice` 为例，看看 Agent 能做什么： ```bash -# Create a new Writer document +# 创建一个 Writer 文档 $ cli-anything-libreoffice document new -o report.json --type writer ✓ Created Writer document: report.json -# Add content +# 添加内容 $ cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1 ✓ Added heading: "Q1 Report" $ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3 ✓ Added 4×3 table -# Export to real PDF via LibreOffice headless +# 通过 LibreOffice headless 导出为真实 PDF $ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite ✓ Exported: output.pdf (42,831 bytes) via libreoffice-headless -# JSON mode for agent consumption +# JSON 模式供 Agent 消费 $ cli-anything-libreoffice --json document info --project report.json { "name": "Q1 Report", @@ -1548,7 +859,7 @@ $ cli-anything-libreoffice --json document info --project report.json } ``` -### REPL Mode +### REPL 模式 ``` $ cli-anything-blender @@ -1572,133 +883,123 @@ Goodbye! 👋 --- -## 📖 The Standard Playbook: HARNESS.md +## 📖 标准手册：HARNESS.md -HARNESS.md is our definitive SOP for making any software agent-accessible via automated CLI generation. +HARNESS.md 是我们通过自动化 CLI 生成，使任意软件具备 Agent 可用性的权威标准操作流程（SOP）。 -It encodes proven patterns and methodologies refined through automated generation processes. +它记录了在自动化生成过程中经验证并沉淀出的模式与方法论。 -The playbook distills key insights from successfully building all 18 diverse, production-ready harnesses. +这本手册提炼了成功构建全部 13 套生产级 CLI 的关键经验。 -### Critical Lessons +### 核心经验 -| Lesson | Description | -|--------|-------------| -| **Use the real software** | The CLI MUST call the actual application for rendering. No Pillow replacements for GIMP, no custom renderers for Blender. Generate valid project files → invoke the real backend. | -| **The Rendering Gap** | GUI apps apply effects at render time. If your CLI manipulates project files but uses a naive export tool, effects get silently dropped. Solution: native renderer → filter translation → render script. | -| **Filter Translation** | When mapping effects between formats (MLT → ffmpeg), watch for duplicate filter merging, interleaved stream ordering, parameter space differences, and unmappable effects. | -| **Timecode Precision** | Non-integer frame rates (29.97fps) cause cumulative rounding. Use `round()` not `int()`, integer arithmetic for display, and ±1 frame tolerance in tests. | -| **Output Verification** | Never trust that export worked because it exited 0. Verify: magic bytes, ZIP/OOXML structure, pixel analysis, audio RMS levels, duration checks. | +| 经验 | 说明 | +|-----|------| +| **必须用真实软件** | CLI 必须调用真实应用进行渲染。不能用 Pillow 替代 GIMP，不能自己写渲染器替代 Blender。正确做法：生成合法的项目文件 → 调用真实后端。 | +| **渲染鸿沟** | GUI 应用在渲染时才应用特效。如果你的 CLI 操作了项目文件但用了简陋的导出工具，特效会被静默丢弃。正确做法：原生渲染器 → 滤镜转译 → 渲染脚本。 | +| **滤镜转译** | 在不同格式间映射特效时（如 MLT → ffmpeg），要注意：重复滤镜合并、交错的流排序、参数空间差异、无法映射的特效。 | +| **时间码精度** | 非整数帧率（如 29.97fps）会导致累积舍入误差。用 `round()` 而非 `int()`，显示时用整数运算，测试中允许 ±1 帧容差。 | +| **输出验证** | 永远不要因为进程退出码为 0 就信任导出成功。要验证：魔术字节、ZIP/OOXML 结构、像素分析、音频 RMS 电平、时长检查。 | -> See the full methodology: [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) +> 完整方法论见：[`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) --- -## 📦 Installation & Usage +## 📦 安装与使用 -### For CLI-Hub Users +### Claude Code 用户 ```bash -# Install the package manager -pip install cli-anything-hub - -# Browse, search, inspect, and install CLIs -cli-hub list -cli-hub search -cli-hub info -cli-hub install - -# Manage installed CLIs -cli-hub update -cli-hub uninstall -cli-hub launch [args...] -``` - -### For Plugin Users (Claude Code) - -```bash -# Add marketplace & install (recommended) +# 添加市场并安装（推荐） /plugin marketplace add HKUDS/CLI-Anything /plugin install cli-anything -# Build a CLI for any software with a codebase -/cli-anything +# 为任何有代码库的软件生成 CLI +/cli-anything:cli-anything <软件路径或仓库> ``` -### For Generated CLIs +### OpenCode 用户 ```bash -# Install any generated CLI -cd /agent-harness +# 克隆仓库 +git clone https://github.com/HKUDS/CLI-Anything.git + +# 请确保使用最新 OpenCode，旧版本可能使用不同的命令目录路径 +# 复制命令和 HARNESS.md 到 OpenCode 命令目录 +cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/ +cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/ + +# 为任何有代码库的软件生成 CLI +/cli-anything <软件路径或仓库> +``` + +### 使用生成的 CLI + +```bash +# 安装任意生成的 CLI +cd <软件名>/agent-harness pip install -e . -# Verify -which cli-anything- +# 验证安装 +which cli-anything-<软件名> -# Use -cli-anything- --help -cli-anything- # enters REPL -cli-anything- --json # JSON output for agents +# 开始使用 +cli-anything-<软件名> --help +cli-anything-<软件名> # 进入 REPL +cli-anything-<软件名> --json <命令> # JSON 输出供 Agent 使用 ``` -### Running Tests +### 运行测试 ```bash -# Run tests for a specific CLI -cd /agent-harness -python3 -m pytest cli_anything//tests/ -v +# 运行某个 CLI 的测试 +cd <软件名>/agent-harness +python3 -m pytest cli_anything/<软件名>/tests/ -v -# Force-installed mode (recommended for validation) -CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything//tests/ -v -s +# 强制安装模式（推荐用于验证） +CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<软件名>/tests/ -v -s ``` --- -## 🤝 Contributing +## 🤝 参与贡献 -We welcome contributions! CLI-Anything is designed to be extensible: +欢迎贡献！CLI-Anything 天然支持扩展： -- **New software targets** — Use the plugin to generate a CLI for any software with a codebase, then submit your harness via [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md). -- **Methodology improvements** — PRs to `HARNESS.md` that encode new lessons learned -- **Plugin enhancements** — New commands, phase improvements, better validation -- **Test coverage** — More E2E scenarios, edge cases, workflow tests +- **新的目标软件** — 用插件为任意有代码库的软件生成 CLI，然后通过 [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) 提交你的成果。 +- **方法论改进** — 向 `HARNESS.md` 提 PR，把新的经验教训沉淀下来 +- **插件增强** — 新命令、阶段优化、更好的验证逻辑 +- **测试覆盖** — 更多端到端场景、边界情况、工作流测试 -### Limitations +### 已知局限 -- **Requires strong foundation models** — CLI-Anything relies on frontier-class models (e.g., Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.4) for reliable harness generation. Weaker or smaller models may produce incomplete or incorrect CLIs that require significant manual correction. -- **Relies on available source code** — The 7-phase pipeline analyzes and generates from source code. When the target software only provides compiled binaries that require decompilation, harness quality and coverage will degrade substantially. -- **May require iterative refinement** — A single `/cli-anything` run may not fully cover all capabilities. Running `/refine` one or more times is often needed to push the CLI's performance and coverage to production quality. - -### Roadmap - -- [ ] Support for more application categories (CAD, DAW, IDE, EDA, scientific tools) -- [ ] Benchmark suite for agent task completion rates -- [ ] Community-contributed CLI harnesses for internal/custom software -- [ ] Integration with additional agent frameworks beyond Claude Code -- [ ] Support packaging APIs for closed-source software and web services into CLIs -- [x] Produce SKILL.md alongside the CLI for agent skill discovery and orchestration +- **依赖强大的基础模型** — CLI-Anything 依赖前沿级别的模型（如 Claude Opus 4.6、Claude Sonnet 4.6、GPT-5.4）才能可靠地生成 harness。较弱或较小的模型可能产出不完整或有误的 CLI，需要大量人工修正。 +- **依赖可用的源代码** — `/cli-anything` 基于源码进行分析和生成。如果目标软件只提供编译后的二进制文件，需要反编译才能获取代码，harness 的质量和覆盖率会显著下降。 +- **可能需要迭代优化** — 单次 `/cli-anything` 运行不一定能完整覆盖所有功能。通常需要执行一次或多次 `/refine` 命令，才能将 CLI 的性能和覆盖率推到生产级水平。 --- -## 📖 Documentation +## 📖 文档 -| Document | Description | -|----------|-------------| -| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | The methodology SOP — single source of truth | -| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | Plugin documentation — commands, options, phases | -| [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5-minute getting started guide | -| [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | Distribution and publishing guide | +| 文档 | 说明 | +|-----|------| +| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | 方法论 SOP — 唯一权威来源 | +| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | 插件文档 — 命令、选项、阶段 | +| [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5 分钟快速上手 | +| [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | 分发与发布指南 | -Each generated harness also includes: -- `.md` — Architecture SOP specific to that application -- `tests/TEST.md` — Test plan and results documentation +每个生成的 CLI 还包含： + +- `<软件名>.md` — 该应用的架构 SOP +- `tests/TEST.md` — 测试计划和结果文档 --- ## ⭐ Star History -If CLI-Anything helps make your software Agent-native, give us a star! ⭐ +如果 CLI-Anything 帮到了你，给个 Star 吧！⭐ + --- -## 📚 Citation +## 📚 引用 -If you find CLI-Anything useful, please cite our technical report: +如果 CLI-Anything 对你有帮助，请引用我们的技术报告： ```bibtex @misc{yang2026clianythingagentnativecomputeruse, @@ -1731,15 +1033,15 @@ If you find CLI-Anything useful, please cite our technical report: ## 📄 License -Apache License 2.0 — free to use, modify, and distribute. +Apache License 2.0 — 可自由使用、修改和分发。 ---
-**CLI-Anything** — *Make any software with a codebase Agent-native.* +**CLI-Anything** — *一行命令，让任何软件成为 Agent 的原生工具。* -A methodology for the age of AI agents | 18 professional software demos | 2,280 passing tests +为 AI Agent 时代而生 | 13 款专业软件实测 | 1,774 项测试全部通过
@@ -1748,6 +1050,6 @@ Apache License 2.0 — free to use, modify, and distribute.

- Thanks for visiting ✨ CLI-Anything!

+ 感谢访问 ✨ CLI-Anything！

Views