CLI-Anything

项目概述

CLI-Anything 致力于让任意软件具备"代理原生"（Agent-Native）能力。其核心理念是：当前软件服务于人类用户，未来将由 AI 代理驱动操作；CLI 作为通用的结构化、可组合、轻量化接口，是连接 LLM 与软件世界的最佳桥梁。该项目同时提供 CLI-Hub 注册中心，便于浏览、安装和管理社区贡献的命令行工具。

为什么选择 CLI

• 结构化与可组合：文本命令契合 LLM 输出格式，可链式编排复杂工作流
• 轻量与通用：开销极低，跨平台无依赖
• 自描述：--help 自动提供代理可发现的文档
• 确定性可靠：一致的结果让代理行为可预测
• 代理优先：结构化 JSON 输出，简化解析复杂度

快速上手

Phase 1：使用现有 CLI 生态

通过 CLI-Hub 包管理器浏览、安装、运行已发布的命令行工具：

pip install cli-anything-hub
cli-hub list                  # 浏览注册表
cli-hub search image          # 关键词搜索
cli-hub install gimp          # 安装
cli-hub launch gimp           # 运行

Phase 1.5：让代理自主发现 CLI

为支持 SKILL 协议的代理安装 CLI-Hub 元技能：

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

随后向代理发出指令即可让其自动挑选并安装合适的 CLI。兼容平台包括 OpenClaw、Nanobot、Claude Code、Codex、Reasonix、Antigravity 等。

Phase 3：为新软件构建 CLI

当注册表中缺少目标软件时，可使用 CLI-Anything 生成器为本地代码库或 GitHub 仓库自动生成完整的 CLI Harness。要求 Python 3.10+，并选择以下任一支持的代理平台：

• Claude Code
• Pi Coding Agent
• OpenCode
• Goose
• Qodercli
• OpenClaw
• Cursor
• Codex
• GitHub Copilot CLI

七阶段构建流程

以 Claude Code 为例，安装插件后只需一条命令：

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything ./gimp

七个阶段依次为：

1. 分析源代码，将 GUI 动作映射到 API
2. 设计命令分组、状态模型与输出格式
3. 基于 Click 构建 CLI（含 REPL、JSON 输出、撤销/重做）
4. 规划单元测试与端到端测试方案
5. 实现完整测试套件
6. 更新文档与测试结果
7. 生成 setup.py 并发布到 PATH

构建后可使用 /cli-anything:refine 迭代扩展覆盖范围，例如：

/cli-anything:refine ./gimp "batch processing and filters"

多平台安装要点

• Pi Coding Agent：克隆仓库后执行 .pi-extension/cli-anything/install.sh 全局安装
• OpenCode：复制 opencode-commands/*.md 与 HARNESS.md 至 ~/.config/opencode/commands/
• Cursor：通过 cursor-plugin/scripts/install.sh 安装生成器插件，Consumer 侧仍使用 cli-hub 与 npx skills
• OpenClaw / Codex：将 SKILL.md 复制到对应代理的 skills 目录

Windows 用户在 Claude Code 上需安装 Git for Windows（含 bash 与 cygpath）或使用 WSL，否则可能出现 cygpath: command not found 错误。

关键命令一览

命令	用途
/cli-anything <path>	构建完整 CLI Harness
/cli-anything:refine <path> [focus]	增量扩展能力覆盖
/cli-anything:test <path>	运行测试
/cli-anything:validate <path>	验证 Harness 完整性
/cli-anything:list	列出全部工具