cli-anything

cli-anything — 让任何软件具备 Agent 原生能力

CLI-Anything（HKUDS）连接 AI Agent 与各类软件：它不再依赖脆弱的 GUI 自动化，而是将真实应用（Blender、GIMP、LibreOffice、OBS、Godot、QGIS 等）封装成结构化、以 Agent 为先的 CLI，提供 Click 命令、有状态 REPL、--json 输出、撤销/重做等功能，并通过 7 阶段流水线生成和验证，覆盖 40 多个测试框架，共通过 2,461 项测试。此技能是一个路由优先的封装层：选择合适的模式、安装合适的接口，并执行构建 → 优化 → 验证的循环。

何时使用此技能

• 用户希望 Agent 通过 CLI 控制真实软件（图像/视频/音频编辑、办公、3D、GIS、游戏引擎、绘图、流媒体），而不是使用屏幕截图或 RPA
• 用户要求安装 cli-anything-hub / 使用 cli-hub （list、search、info、install、update、uninstall、launch）
• 用户希望 Agent 通过 CLI-Hub 元技能自主发现并安装 CLI
• 用户希望使用 /cli-anything 基于本地代码库或 GitHub 仓库生成新的 CLI 测试框架，或询问如何为 Claude Code、Codex、OpenCode、OpenClaw、Pi、 Hermes、Qodercli 或 GitHub Copilot CLI 安装 CLI-Anything 插件/技能
• 用户希望使用 /cli-anything:refine、/cli-anything:test 或 /cli-anything:validate 扩展或验证现有测试框架

何时不要使用此技能

• 用户想要设计特定领域的 Agent 团队（Agent + 技能脚手架），而非软件 CLI 封装层 → 使用 harness2
• 用户只是想浏览/安装Claude 插件 → 使用 ccpi-marketplace
• 目标没有代码库和 API，必须通过真实的浏览器/GUI 会话操作 → 使用 browser-harness（如果浏览器已经打开，则使用 playwriter）
• 用户只需要网页抓取/提取 → 使用 scrapling

前置条件

要求	备注
Python 3.10+	CLI-Hub 和生成的测试框架基于 Python/Click
目标软件	测试框架会调用真实后端，因此也要安装上游应用（GIMP、Blender 等）
前沿编码 Agent	生成测试框架需要强大的模型（Claude Opus/Sonnet 级别）；较弱的模型会降低质量
源代码访问权限	7 阶段生成器基于源代码运行；仅提供二进制文件的目标会大幅降低效果

说明

步骤 1 — 选择模式

模式	适用场景	入口
使用生态系统	可能已有现成的测试框架	pip install cli-anything-hub → cli-hub search <kw>
赋能 Agent	Agent 应自行选择/安装 CLI	npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y
生成测试框架	软件尚未收录	平台插件/技能 → /cli-anything <path-or-repo>
迭代测试框架	覆盖不足、流程失败	/cli-anything:refine · :test · :validate

优先使用注册表——构建是备用方案，而非默认选项。

步骤 2 — 通过 CLI-Hub 使用生态系统

pip install cli-anything-hub

cli-hub list                 # browse the registry
cli-hub search image         # search by keyword
cli-hub info gimp            # inspect one CLI
cli-hub install gimp         # install from CLI-Hub
cli-hub launch gimp          # run an installed CLI
cli-hub update gimp          # update
cli-hub uninstall gimp       # remove

CLI-Hub v0.2.0+ 还可通过 public_registry.json 从多个安装源（ pip、npm、brew、捆绑/系统工具）提供公共 CLI。 如果测试框架封装的是桌面软件（GIMP、Blender、LibreOffice 等）， 也要安装对应的上游应用。

步骤 3 — 为 Agent 提供元技能

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

然后向 Agent 提示：

Find appropriate CLI software in CLI-Hub and complete the task: ...

兼容 Claude Code、Codex、OpenClaw、Nanobot、Antigravity 及其他 兼容 SKILL 的 Agent。此单体仓库中各测试框架对应的技能也可发现：npx skills add HKUDS/CLI-Anything --list。

第 4 步 — 生成新 harness（7 阶段流水线）

Claude Code（主要平台）：

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

/cli-anything ./gimp                              # local source
/cli-anything https://github.com/blender/blender  # GitHub repo

流水线包括：1 分析 → 2 设计 → 3 实现（Click CLI + REPL + JSON + 撤销/重做）→ 4 规划测试 → 5 编写测试 → 6 编写文档（+ 第 6.5 阶段 生成 SKILL.md）→ 7 发布（setup.py、安装到 PATH）。 其他平台（Codex、OpenCode、OpenClaw、Pi、Hermes、Qodercli、Copilot CLI、Goose）采用相同的方法 — 安装命令见 references/commands.md。

如果无法识别 /cli-anything：运行 /reload-plugins，使用 /help cli-anything 验证，从 marketplace 重新安装，并且仅在较旧的 版本中尝试旧版 /cli-anything:cli-anything 形式。

第 5 步 — 优化、测试、验证

/cli-anything:refine ./gimp                                  # broad gap analysis
/cli-anything:refine ./gimp "batch processing and filters"   # focused
/cli-anything:test ./gimp                                    # run tests, update TEST.md
/cli-anything:validate ./gimp                                # check against HARNESS.md

优化是渐进且非破坏性的 — 可反复运行，让覆盖范围逐步达到生产级质量。HARNESS.md 是 验证器据以检查的方法论 SOP（事实来源）。

第 6 步 — 使用生成的 CLI

cd <software>/agent-harness && pip install -e .

cli-anything-gimp --help                     # discoverable via --help/which
cli-anything-gimp --json layer add -n "BG"   # structured output for agents
cli-anything-gimp                            # bare command → stateful REPL

每个 harness 都提供双模式（REPL + 子命令）、每条 命令均支持 --json，并在 skills/cli-anything-<name>/SKILL.md 生成 SKILL.md。

第 7 步 — 与 jeo-skills 并行进行插件式安装

此技能文件夹可通过标准 jeo-skills 流程作为插件安装，以便将包装器、参考资料和安装脚本放到磁盘上，供任何受支持的 Agent 运行时使用：

# Project install (writes into .agents/skills/cli-anything/)
npx skills add https://github.com/akillness/jeo-skills --skill cli-anything

# Global install for every detected agent
npx skills add -g https://github.com/akillness/jeo-skills --skill cli-anything

# Target specific agents
npx skills add -g https://github.com/akillness/jeo-skills --skill cli-anything -a claude-code -a codex -y

此技能还提供 scripts/install.sh — 一键式 CLI-Hub 安装程序（支持 venv 的 uv/pip 选择，兼容 PEP 668），并可选择通过 CLI_ANYTHING_META_SKILL=1 安装元技能。

输出格式

当用户请求 cli-anything 提供帮助时，返回简洁的说明：

# cli-anything Routing Brief

## Scope
- Mode: use-ecosystem | empower-agents | generate-harness | iterate-harness
- Target software: <name or repo> | undecided
- Agent platform: claude | codex | opencode | openclaw | pi | hermes | copilot | other

## Recommended next move
- install-cli-hub | cli-hub-search | install-meta-skill | install-platform-plugin | run-/cli-anything | refine | test | validate

## Why
- 2-3 bullets grounded in the user's packet

## Route-outs
- `harness2` for agent-team and agent-harness design (not software wrappers)
- `browser-harness` for no-codebase GUI/browser targets
- `ccpi-marketplace` for general Claude plugin browsing

最佳实践

1. 生成前先搜索注册表 — 已有 40 多个 harness；cli-hub search 只需几秒，而 7 阶段构建需要一整个会话。
2. 安装实际后端 — harness 会调用真正的软件，不依赖妥协方案；缺少后端时测试会失败（而不是跳过）。
3. 使用 --json 供 Agent 使用 — 每条命令都支持此选项；人类可读表格仅用于调试。
4. 验证输出，而非退出代码 — 方法论会检查 magic bytes、ZIP/OOXML 结构、像素/音频分析；对产物也应如此。
5. 反复运行 /cli-anything:refine — 单次生成通常无法覆盖所有功能；每次优化都是渐进式的。
6. Windows 需要 bash — 安装 Git for Windows（包含 bash + cygpath），或先使用 WSL，再运行插件命令。

参考资料

• 上游仓库：https://github.com/HKUDS/CLI-Anything
• CLI-Hub（网页）：https://hkuds.github.io/CLI-Anything/
• 方法论 SOP：cli-anything-plugin/HARNESS.md
• 快速入门：cli-anything-plugin/QUICKSTART.md
• 发布指南：cli-anything-plugin/PUBLISHING.md
• 技术报告：https://arxiv.org/abs/2606.03854
• 安装脚本：scripts/install.sh
• 命令与平台参考：references/commands.md
• 相关技能：../harness2/SKILL.md、../ccpi-marketplace/SKILL.md、 ../browser-harness/SKILL.md、../scrapling/SKILL.md
• 许可证：Apache-2.0（参见上游 LICENSE）