开源项目

CLI-Anything

CLI-Anything

为任意软件自动生成AI Agent可调用的CLI接口,通过7阶段流水线将代码仓库转化为结构化命令行工具。亮点在于支持GIMP、Blender等18+专业软件,生成代码带有JSON输出、REPL模式及2000+测试用例,让Agent无需GUI即可操控复杂应用。配合CLI-Hub社区仓库可实现一键安装和发现。

README

  CLI-Anything:让所有软件原生支持Agent

今天的软件服务人类👨‍💻。明天的用户将是Agent🤖。
CLI-Anything:弥合AI Agent与世界软件之间的鸿沟

🌐 CLI-Hub: pip install cli-anything-hub 然后 cli-hub install <name> — 浏览、安装和管理所有社区构建的 CLI。想添加自己的?提交一个 PR — Hub 会立即更新。

🎬 查看演示: 观看 AI agent 使用生成的 CLI 配合预览、实时预览和轨迹循环生成真实产物 — CAD 构建、3D 场景、图表、游戏玩法、字幕等。

🙋 [成为贡献者,或请求某个 CLI 工具]: 加入我们!注册来构建一个新的 CLI harness(适配器)—— 一旦审核通过并合并,你将作为社区贡献者获得访问权限!希望 CLI-Anything 支持某个特定的软件或服务?提交 心愿单请求!

快速开始 CLI Hub 演示 测试 许可证

Python Click Pytest 覆盖率 输出 飞书 微信

一个命令行:让任何软件对 Pi、OpenClaw、nanobot、Cursor、Claude Code 等 agent 做好准备。  中文文档 | 日本語ドキュメント

CLI-Anything 打字演示

CLI-Anything 预告图


📰 新闻

感谢社区的所有宝贵贡献!每天都有更多更新。

  • 2026-04-18 🧩 所有 SKILL.md 文件现已统一归并到顶层 skills/ 目录下 —— 每个 CLI skill 都可以通过 npx skills add HKUDS/CLI-Anything --skill <skill-name> -g -y 从统一源安装。我们还添加了根级 skill 验证 CI,将贡献/PR 文档以及 REPL skill 路径提示同步到新布局,并围绕新的 npx skills 流程刷新了 CLI-Hub 先安装的前端。

  • 2026-04-17 🌐 CLI-Hub 再次优化了安装体验 —— 收紧了公共 registry 元数据和 skill 覆盖率,修正了访问计数,并进一步完善了 Web hub。 🧪 Shotcut 渲染输出时长修复 (#92)。 📝 SKILL 贡献路径已根据新文档流程修正 (#224),skill 生成器现在能安全处理空的简介 (#203)。

  • 2026-04-16 🗺️ QGIS CLI 合并 (#207) —— 一个完整的 GIS/地图编辑 harness 落地。 🧬 UniMol Tools CLI 合并 (#219) —— 用于分子建模工作流程。 🌐 CLI-Hub 还增加了更多公共 CLI,包括 py4csr,刷新了其生成的 meta-skill,修正了 SKILL 贡献文档,并修复了 skill 生成中的 apt-get 包提取问题 (#204)。

  • 2026-04-16 📈 Unreal Insights CLI 扩展 —— 新增后台捕获会话控制(capture start/status/snapshot/stop),引擎根匹配的 UnrealInsights.exe 解析/构建流程,以及针对新编排工作流程的文档/测试刷新。

  • 2026-04-15 🌐 CLI-Hub 更新至 v0.2.0 —— PyPI 包现在支持来自多个安装源的公共 CLI(pip、npm、brew、捆绑/系统工具),由新的 public_registry.json 支撑。Hub 前端进行了重新设计,分为 CLI-Anything CLIs 和 Public CLIs 两套牌组,实时的端到端检查现在覆盖 pip 和 npm 包的实际安装、更新和卸载流程。

  • 2026-04-14 🧭 Safari CLI 合并 (#212) 并添加到 Hub registry —— 通过 safari-mcp 实现的浏览器自动化。 🎬 Kdenlive 还收到了 Gen 5 项目输出和无效项目生成的兼容性修复。

  • 2026-04-13 📓 Obsidian CLI 合并 (#211) —— 通过 Local REST API 实现的知识管理 harness,包含 48 个单元测试和 7 个 E2E 测试。 ⛓️ Eth2-Quickstart CLI 合并 (#195) —— 以太坊质押节点管理 harness。 📚 Zotero CLI 更新至 v0.4.1 (#201) —— 现在从独立仓库发布,CLI-Hub 获得了对远程 skill_md URL 的支持。

  • 2026-04-11 🔗 n8n CLI 合并 (#188) —— 用于自托管自动化流程的工作流自动化 harness。 🔧 Exa CLI 修复 (#205) 添加了 x-exa-integration 头用于使用跟踪。 📦 CLI-Hub 还获得了其 PyPI 自动发布工作流程和包刷新流水线。

  • 2026-04-10 📦 CLI-Hub 包管理器 发布 —— pip install cli-anything-hub 用于通过一个命令浏览、搜索、安装、更新和卸载 CLI-Anything harness。Web Hub 也推出了首个专注于安装的前端刷新和“赋能自己”工具包卡片。

更早的新闻(4 月 1 日–9 日)
  • 2026-04-09 🧹 清理和文档处理 (#200) —— 修复了 Openscreen 测试小计,将 Openscreen 加入中文 README 和项目结构,并在文档中澄清 /cli-anything 命令语法。

  • 2026-04-08 🎬 Openscreen CLI 合并 (#183) —— 屏幕录制编辑器 harness,101 项测试。 ☁️ CloudAnalyzer CLI 合并 (#181) —— 云成本分析 harness,27 个命令。 🌊 SeaClip / PM2 / ChromaDB harness 合并 (#129)。

  • 2026-04-07 🔄 Dify Workflow CLI 合并 (#191) —— 工作流自动化包装器。 🔧 Inkscape 自动保存修复 (#193, 修复 #182)。 🛡️ DomShell 安全强化 (#156) —— 浏览器 CLI 的 URL 验证和 DOM 清理。 🥧 Pi Coding Agent 扩展 合并 (#178)。

  • 2026-04-06 🔍 Exa CLI 合并 (#172) —— 基于 AI 的 Web 搜索和答案 harness。 🎮 Godot CLI 合并 (#140) —— 游戏引擎 harness,包含完整的演示游戏 E2E 流水线。 ☁️ CloudAnalyzer 审查修复和前端改进也已落地。

  • 2026-04-03 🧪 WireMock CLI 合并 (#170) —— 用于 API 测试的 HTTP 模拟服务器 harness。 🥧 Pi Coding Agent 扩展支持也已落地,并在文档中添加了 CLI 演示录制。

  • 2026-04-01 ⚔️ Slay the Spire II CLI 合并 (#148) —— 卡牌构筑肉鸽游戏 harness。 🎥 VideoCaptioner CLI 合并 (#166) —— 基于 AI 的视频字幕生成 harness。 🛰️ IntelWatch 已添加到 registry,用于 B2B OSINT 工作流程。

更早的新闻(3 月 23 日–30 日)
  • 2026-03-30 🏗️ CLI-Anything v0.2.0 —— HARNESS.md 渐进式公开重新设计。详细指南提取到 guides/ 目录以便按需加载。阶段 1–7 现在连续排列。关键原则和规则合并为一个权威部分。

  • 2026-03-29 📐 Blender skill 文档更新 —— 强制使用绝对渲染路径并修正先决条件。

  • 2026-03-28 🌐 CLIBrowser 添加到 CLI-Hub registry,用于 agent 可访问的浏览器自动化。

  • 2026-03-27 📚 Zotero SKILL.md 增强,添加了面向 agent 的约束;REPL 配置和可执行文件解析修复。

  • 2026-03-26 📖 Zotero CLI harness 落地,用于 Zotero 桌面(库管理、集合、引文)。Draw.io 自定义 ID 错误修复 (#132) 和 registry.json 语法修复。

  • 2026-03-25 🎮 RenderDoc CLI 合并,用于 GPU 帧捕获分析。FreeCAD 更新至 v1.1。Blender EEVEE 引擎名称修正。Zoom token 权限强化。

  • 2026-03-24 🏭 FreeCAD CLI 添加,包含 17 个组的 258 个命令。iTerm2 和 Teltonika RMS harness 添加到 registry。

  • 2026-03-23 🤖 发布 CLI-Hub meta-skill —— agent 现在可以自主发现和安装 CLI。Krita CLI harness 合并,用于数字绘画。

更早的新闻(3 月 11 日–22 日)
  • 2026-03-22 🎵 MuseScore CLI 合并,支持移调、导出和乐器管理。

  • 2026-03-21 🔧 基础设施改进 —— 跨多个 CLI 优化了测试 harness 和文档。增强了多个后端的 Windows 兼容性。

  • 2026-03-20 🌐 Novita AI CLI 添加,用于 OpenAI 兼容的 API 访问。Registry 元数据改进,便于 Hub 发现。

  • 2026-03-19 📦 跨 harness 的包结构优化。改进了 SKILL.md 生成,提供了更好的命令文档。

  • 2026-03-18 🧪 测试覆盖率扩展 —— 跨多个 CLI 增加了额外的 E2E 场景和边界情况验证。

  • 2026-03-17 🌐 发布 CLI-Hub —— 一个中央注册中心,您可以通过一个 pip 命令浏览、搜索和安装任何 CLI。

  • 2026-03-16 🤖 添加 SKILL.md 生成(阶段 6.5) —— 每个生成的 CLI 现在都附带一个 AI 可发现的 skill 定义。

  • 2026-03-15 🐾 来自社区的对 OpenClaw 的支持!合并了 Windows cygpath 防护以实现跨平台支持。

  • 2026-03-14 🔒 修复了 GIMP Script-Fu 路径注入漏洞,并添加了日文 README 翻译。

  • 2026-03-13 🔌 Qodercli 插件作为社区贡献正式合并,并包含专门的设置脚本。

  • 2026-03-12 📦 Codex skill 集成落地,将 CLI-Anything 带到了另一个 AI 编码平台。

  • 2026-03-11 📞 Zoom 视频会议 harness 作为第 11 个支持的应用程序添加。


🤔 为什么是 CLI?

CLI 是人类和 AI agent 的通用接口:

• 结构化且可组合 —— 文本命令匹配 LLM 格式,并可链式组合用于复杂工作流

• 轻量且通用 —— 开销极小,可跨所有系统工作,无需依赖

• 自描述 —— --help 标志提供 agent 可自动发现的文档

• 经过验证的成功 —— Claude Code 每天通过 CLI 运行数千个真实工作流

• Agent 优先设计 —— 结构化 JSON 输出消除了解析复杂性

• 确定且可靠 —— 一致的结果可实现可预测的 agent 行为

🚀 快速开始

先决条件

选择您的平台

⚡ Claude Code

步骤 1:添加市场

CLI-Anything 以托管在 GitHub 上的 Claude Code 插件市场形式分发。

# 添加 CLI-Anything 市场
/plugin marketplace add HKUDS/CLI-Anything

步骤 2:安装插件

# 从市场安装 cli-anything 插件
/plugin install cli-anything

就这样。该插件现在可以在您的 Claude Code 会话中使用。

Windows 用户注意: Claude Code 通过 bash 运行 shell 命令。在 Windows 上,请安装 Git for Windows(包含 bash 和 cygpath)或使用 WSL;否则命令可能会失败,显示 cygpath: command not found。

步骤 3:用一个命令构建 CLI

# /cli-anything <软件路径或仓库>
# 为 GIMP 生成一个完整的 CLI(全部 7 个阶段)
/cli-anything ./gimp

跨 Claude Code 版本的命令兼容性:

  • 使用 /cli-anything 作为主要入口点。
  • 在确认插件已安装并加载后,如果 /cli-anything 仍不被识别,请尝试旧版入口形式 /cli-anything:cli-anything。
  • 辅助命令保留 :子命令 形式(例如 /cli-anything:refine)。

如果您看到 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. 确认插件可用后,重试入口命令:
    • 首选:/cli-anything ./gimp
    • 仅旧版本:/cli-anything:cli-anything ./gimp

这将运行完整的流水线:

  1. 🔍 分析 —— 扫描源代码,将 GUI 动作映射到 API
  2. 📐 设计 —— 构建命令组、状态模型、输出格式
  3. 🔨 实现 —— 构建带 REPL、JSON 输出、撤销/重做的 Click CLI
  4. 📋 规划测试 —— 创建包含单元 + E2E 测试计划的 TEST.md
  5. 🧪 编写测试 —— 实现全面的测试套件
  6. 📝 文档 —— 使用结果更新 TEST.md
  7. 📦 发布 —— 创建 setup.py,安装到 PATH

步骤 4(可选):优化和改进 CLI

在初始构建之后,您可以迭代地优化 CLI,以扩大覆盖率并添加缺失的能力:

# 全面优化 —— agent 分析所有能力中的差距
/cli-anything:refine ./gimp

# 聚焦优化 —— 针对特定功能领域
/cli-anything:refine ./gimp "我想要更多关于图像批处理和滤镜的 CLI"

refine 命令对软件的全部能力和当前 CLI 覆盖率进行差距分析,然后为识别出的差距实现新命令、测试和文档。您可以多次运行它以稳步扩大覆盖率 —— 每次运行都是增量的且非破坏性的。

替代方案:手动安装

如果您不想使用市场:

# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 将插件复制到 Claude Code 插件目录
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything

# 重新加载插件
/reload-plugins
⚡ Pi Coding Agent

步骤 1:安装扩展

扩展位于此仓库的 .pi-extension/cli-anything/ 目录。全局安装它,使 /cli-anything 命令在所有 Pi 项目中可用:

# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git
cd CLI-Anything

# 全局安装到 Pi 的扩展目录
bash .pi-extension/cli-anything/install.sh

要卸载:

bash .pi-extension/cli-anything/install.sh --uninstall

工作原理: install.sh 将扩展文件(包括来自 cli-anything-plugin/ 的 HARNESS.md、命令、指南、脚本和模板)复制到 ~/.pi/agent/extensions/cli-anything/,Pi 在启动时会自动发现。在 Pi 中运行 /reload 或重启 Pi 以激活。

步骤 2:用一个命令构建 CLI

扩展加载后,以下命令可用:

# 为 GIMP 生成一个完整的 CLI(全部 7 个阶段)
/cli-anything ./gimp

# 从 GitHub 仓库构建
/cli-anything https://github.com/blender/blender

步骤 3(可选):优化和改进 CLI

# 全面优化 —— agent 分析所有能力中的差距
/cli-anything:refine ./gimp

# 聚焦优化 —— 针对特定功能领域
/cli-anything:refine ./gimp "批处理和滤镜"

可用命令

命令 描述
/cli-anything <path-or-repo> 构建一个完整的 CLI harness
/cli-anything:refine <path> [focus] 优化现有的 CLI harness
/cli-anything:test <path-or-repo> 运行 CLI harness 的测试
/cli-anything:validate <path-or-repo> 验证 CLI harness
/cli-anything:list [options] 列出所有 CLI-Anything 工具
⚡ OpenCode(实验性)

步骤 1:安装命令

注意: 请升级到最新的 OpenCode。旧版本可能使用不同的命令路径。

将 CLI-Anything 命令 和 HARNESS.md 复制到您的 OpenCode 命令目录:

# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 全局安装(所有项目中可用)
cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/

# 或项目级安装
cp CLI-Anything/opencode-commands/*.md .opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/

注意: 请升级到最新的 OpenCode。旧版本使用 command/(单数)而不是 commands/。如果 commands/ 不存在,请对全局和项目级安装均使用 command/。

注意: HARNESS.md 是所有命令引用的方法规范。它必须与命令位于同一目录。

这将添加 5 个斜杠命令:/cli-anything、/cli-anything-refine、/cli-anything-test、/cli-anything-validate 和 /cli-anything-list。

步骤 2:用一个命令构建 CLI

# 为 GIMP 生成一个完整的 CLI(全部 7 个阶段)
/cli-anything ./gimp

# 从 GitHub 仓库构建
/cli-anything https://github.com/blender/blender

该命令作为子任务运行,并遵循与 Claude Code 相同的 7 阶段方法。

步骤 3(可选):优化和改进 CLI

# 全面优化 —— agent 分析所有能力中的差距
/cli-anything-refine ./gimp

# 聚焦优化 —— 针对特定功能领域
/cli-anything-refine ./gimp "批处理和滤镜"
⚡ Goose(桌面版 / CLI) 实验性 社区

步骤 1:安装 Goose

根据官方 Goose 说明为您的操作系统安装 Goose(桌面版或 CLI)。

步骤 2:配置 CLI 提供商

将 Goose 配置为使用 CLI 提供商,例如 Claude Code,并确保该 CLI 已安装并认证。

步骤 3:在 Goose 会话中使用 CLI-Anything

配置完成后,启动一个会话并使用上述针对 Claude Code 的相同 CLI-Anything 命令,例如:

/cli-anything ./gimp
/cli-anything:refine ./gimp "批处理和滤镜"

注意:当 Goose 通过 CLI 提供商运行时,它使用该提供商的能力和命令格式。

⚡ Qodercli 社区

步骤 1:注册插件

git clone https://github.com/HKUDS/CLI-Anything.git
bash CLI-Anything/qoder-plugin/setup-qodercli.sh

这将在 ~/.qoder.json 中注册 cli-anything 插件。注册后启动一个新的 Qodercli 会话。

步骤 2:从 Qodercli 使用 CLI-Anything

/cli-anything ./gimp
/cli-anything:refine ./gimp "批处理和滤镜"
/cli-anything:validate ./gimp
⚡ OpenClaw 社区

步骤 1:安装 Skill

CLI-Anything 提供了一个原生的 OpenClaw SKILL.md 文件。将其复制到您的 OpenClaw skill 目录:

# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 安装到全局 skill 文件夹
mkdir -p ~/.openclaw/skills/cli-anything
cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md

步骤 2:构建 CLI

现在您可以在 OpenClaw 中调用该 skill:

@cli-anything build a CLI for ./gimp

该 skill 遵循与 Claude Code 和 OpenCode 相同的 7 阶段方法。

⚡ Codex 实验性 社区

步骤 1:安装 Skill

运行捆绑的安装程序:

# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 安装 skill
bash CLI-Anything/codex-skill/scripts/install.sh

在 Windows PowerShell 上,使用:

.\CLI-Anything\codex-skill\scripts\install.ps1

这会将 skill 安装到 $CODEX_HOME/skills/cli-anything(如果未设置 CODEX_HOME,则为 ~/.codex/skills/cli-anything)。

安装后重启 Codex 以使其被发现。

步骤 2:从 Codex 使用 CLI-Anything

用自然语言描述任务,例如:

使用 CLI-Anything 为 ./gimp 构建一个 harness
使用 CLI-Anything 优化 ./shotcut 的画中画工作流
使用 CLI-Anything 验证 ./libreoffice

Codex skill 适应了 Claude Code 插件和 OpenCode 命令所使用的相同方法,同时保持生成的 Python harness 格式不变。

⚡ GitHub Copilot CLI 社区

步骤 1:安装插件

git clone https://github.com/HKUDS/CLI-Anything.git
cd CLI-Anything
copilot plugin install ./cli-anything-plugin

这会将 CLI-Anything 插件安装到 GitHub Copilot CLI。该插件现在应该在您的 GitHub Copilot CLI 会话中可用。

步骤 2:从 GitHub Copilot CLI 使用 CLI-Anything

/cli-anything ./gimp
/cli-anything:refine ./gimp "批处理和滤镜"
/cli-anything:validate ./gimp
🔮 更多平台(即将推出)

CLI-Anything 设计为平台无关的。计划支持更多 AI 编码 agent:

  • Codex —— 可通过 codex-skill/ 中的捆绑 skill 使用
  • Cursor —— 即将推出
  • Windsurf —— 即将推出
  • 您最喜欢的工具 —— 欢迎贡献!请参阅 opencode-commands/ 目录了解参考实现。

使用生成的 CLI

无论您使用哪个平台构建,生成的 CLI 都以相同方式工作:

# 安装到 PATH
cd gimp/agent-harness && pip install -e .

# 从任何地方使用
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"

# 进入交互式 REPL
cli-anything-gimp

每个仓库内的 harness 现在在 skills/cli-anything-<software>/SKILL.md 有一个规范的 SKILL.md,这使得 monorepo 可以直接通过 npx skills add HKUDS/CLI-Anything --list 被发现。已安装的 harness 包仍然在 cli_anything/<software>/skills/SKILL.md 提供一个兼容副本,并且 REPL 横幅在存在时优先使用仓库根目录的规范文件,否则回退到打包的副本。


🤖 用 CLI-Hub 赋能您的 Agent

CLI-Hub 允许 agent 自主发现和安装它们需要的 CLI —— 无需人工干预。

我们发布了一个 meta-skill,允许任何 AI agent 自由探索社区 CLI 的完整目录,并为任务选择正确的 CLI。

一键安装:

# OpenClaw
openclaw skills install cli-anything-hub

# nanobot
nanobot skills install cli-anything-hub

然后只需给您的 agent 一个提示:

在 CLI-Hub 中找到合适的 CLI 软件并完成任务:<您的任务>

agent 将浏览目录,安装任何适合任务的 CLI,并使用它 —— 全部自主完成。

底层工作原理:

  1. meta-skill 指向位于 https://reeceyang.sgp1.cdn.digitaloceanspaces.com/SKILL.md 的实时目录
  2. agent 读取按类别组织的 20 多个 CLI,并提供一行 pip install 命令
  3. agent 安装适合任务的 CLI,然后读取该 CLI 自己的 SKILL.md 以获取详细用法

当 registry.json 发生变化时,目录自动更新 —— 新的社区 CLI 会自动出现。

对于 Claude Code 用户: 将 skills/cli-hub-meta-skill/SKILL.md 复制到您的项目或 skills 目录,以获得相同的自动 CLI 发现功能。


💡 CLI-Anything 的愿景:构建 Agent 原生软件

• 🌐 通用访问 —— 每个软件都可通过结构化 CLI

[原 README 过长已截断]

开源项目HKUDS2026-05-17原文

相关内容