README

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


  今天的软件为人而生👨‍💻，明天的用户是 Agent🤖
CLI-Anything：连接 AI Agent 与全世界软件的桥梁


🌐 CLI-Hub：在 CLI-Hub 探索社区已构建的所有 CLI，一条命令即可安装。想贡献你的 CLI？提交 PR — Hub 会即时更新。


  
  
  
  
  



  
  
  
  
  
  



一行命令，让任意软件接入 OpenClaw、nanobot、Cursor、Claude Code 等 Agent 框架。


  



  


---

 🤔 为什么是 CLI？

CLI 是人类和 AI Agent 共通的万能接口：

• 结构化、可组合 - 文本命令天然匹配 LLM 的输入格式，可自由串联成复杂工作流

• 轻量且通用 - 几乎零开销，跨平台运行，不依赖额外环境

• 自描述 - 一个 --help 就能让 Agent 自动发现所有功能

• 久经验证 - Claude Code 每天通过 CLI 执行数以千计的真实任务

• Agent 友好 - 结构化 JSON 输出，Agent 无需任何额外解析

• 确定且可靠 - 输出稳定一致，Agent 行为可预测

 🚀 快速上手

 环境要求

- Python 3.10+
- 目标软件已安装（如 GIMP、Blender、LibreOffice 或你自己的应用）
- 支持的 AI 编程工具之一：Claude Code | Cursor | OpenClaw | OpenCode | Codex | Qodercli | GitHub Copilot CLI | 更多平台

 选择你的平台


⚡ Claude Code

第一步：添加插件市场

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

bash
 添加 CLI-Anything 插件市场
/plugin marketplace add HKUDS/CLI-Anything


第二步：安装插件

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


搞定。插件已经在你的 Claude Code 会话中可用了。

Windows 注意： Claude Code 通过 bash 执行命令。Windows 下请安装 Git for Windows（包含 bash 和 cygpath）
或使用 WSL，否则可能出现 cygpath: command not found。

第三步：一行命令生成 CLI

bash
 /cli-anything 
 为 GIMP 生成完整的 CLI（7 个阶段全自动）
/cli-anything ./gimp

 兼容写法（旧版本 Claude Code 可重试）
 /cli-anything:cli-anything ./gimp


Claude Code 不同版本的命令兼容说明：
- 优先使用 /cli-anything 作为主入口。
- 在已确认插件已安装并加载的情况下，若旧版本的 Claude Code 不识别 /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. 🔨 实现 — 构建 Click CLI，包含 REPL、JSON 输出、撤销/重做
4. 📋 规划测试 — 生成 TEST.md，涵盖单元测试和端到端测试计划
5. 🧪 编写测试 — 实现完整测试套件
6. 📝 文档 — 更新 TEST.md，写入测试结果
7. 📦 发布 — 生成 setup.py，安装到 PATH

第四步（可选）：优化和扩展 CLI

初始构建完成后，你可以迭代优化 CLI，扩展覆盖面并补充缺失的功能：

bash
 全面优化 — Agent 分析所有功能的覆盖差距
/cli-anything:refine ./gimp

 定向优化 — 指定特定功能领域
/cli-anything:refine ./gimp "我需要更多图像批处理和滤镜相关的 CLI"


优化命令会对软件的完整功能与当前 CLI 覆盖范围进行差距分析，然后为识别到的差距实现新命令、测试和文档。你可以多次运行该命令，逐步扩大功能覆盖范围 — 每次运行都是增量的、非破坏性的。


备选方案：手动安装

如果你不想用插件市场：

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

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

 重新加载插件
/reload-plugins







⚡ OpenCode （实验性支持）

第一步：安装命令

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

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

bash
 克隆仓库
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-any

Top issues

Discussions

Latest release

Highlights
 CLI-Matrix — a new cli-hub matrix command family that turns curated, multi-CLI workflow "matrices" into one-shot, capability-driven installs. Discover with cli-hub matrix list/search and cli-hub can , inspect with matrix info/doctor, verify capability coverage with matrix preflight, and provision an entire workflow with matrix install (recipes, scoped installs, dry-run, resume). Ships cli-anything-hub 0.4.0 to PyPI with matrix.py / matrix_skill.py and unified install/preflight/discover analytics.
 30 new CLIs added across creative, productivity, dev, and data domains — including Ar