Skip to content
CLI-Anything 中文指南

快速开始

🚀 5 分钟快速上手

Section titled “🚀 5 分钟快速上手”

CLI-Anything 提供两种使用路径：直接使用已有的 CLI 工具，或为任意新软件生成 CLI。选择适合你的路径开始吧！

📋 前置要求

Section titled “📋 前置要求”
要求说明
Python3.10 或更高版本
目标软件你想让 Agent 操控的软件（路径 2 需要）
AI Agent支持以下任一平台

支持的 AI Agent 平台

Section titled “支持的 AI Agent 平台”

CLI-Anything 生成的 CLI 工具兼容以下主流 AI Agent 平台：

  • Claude Code — Anthropic 的编程 Agent
  • Pi — Inflection AI 的个人 AI 助手
  • OpenClaw — 开源 Agent 框架
  • OpenCode — AI 编程助手
  • Codex — OpenAI 的代码生成模型
  • Qodercli — AI 命令行编程工具
  • GitHub Copilot CLI — GitHub 的 AI 编程助手

🛤️ 路径一：使用现有 CLI

Section titled “🛤️ 路径一：使用现有 CLI”

如果你需要的软件已经在支持列表中，可以直接安装使用。

1. 安装 CLI Hub

Section titled “1. 安装 CLI Hub”
Terminal window
pip install cli-anything-hub

2. 搜索可用 CLI

Section titled “2. 搜索可用 CLI”
Terminal window
cli-hub search gimp

3. 安装 CLI 工具

Section titled “3. 安装 CLI 工具”
Terminal window
cli-hub install gimp

4. 验证安装

Section titled “4. 验证安装”
Terminal window
gimp --help

5. 在 Agent 中使用

Section titled “5. 在 Agent 中使用”

安装完成后，AI Agent 可以直接通过命令行调用：

Terminal window
# Agent 可以执行这样的命令
gimp open photo.jpg --resize 800x600 --output photo_resized.jpg
gimp filter gaussian-blur --radius 5
gimp export --format png --quality 95

常用 cli-hub 命令

Section titled “常用 cli-hub 命令”
命令说明
cli-hub search <name>搜索可用的 CLI 工具
cli-hub install <name>安装指定的 CLI 工具
cli-hub list列出已安装的 CLI 工具
cli-hub update <name>更新指定的 CLI 工具
cli-hub uninstall <name>卸载指定的 CLI 工具

查看完整的支持列表 →

🛤️ 路径二：构建新的 CLI

Section titled “🛤️ 路径二：构建新的 CLI”

如果你想为尚未支持的软件生成 CLI，使用 7 阶段自动生成器。

1. 安装 Agent 元技能

Section titled “1. 安装 Agent 元技能”

在你的 AI Agent 中安装 CLI-Anything 的元技能（Meta Skill）：

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

这个元技能会让你的 Agent 知道如何使用 CLI-Anything 的生成流程。

2. 启动生成流程

Section titled “2. 启动生成流程”

向你的 Agent 发出指令，例如：

“请为 Shotcut 视频编辑器生成一个 CLI 接口”

Agent 会自动执行以下 7 个阶段：

阶段名称说明
1API 分析分析目标软件的 API/插件接口
2命令设计设计 CLI 命令结构和参数
3代码生成生成 CLI 工具代码
4帮助文档生成 --help 文档
5SKILL.md生成 Agent 技能描述文件
6单元测试生成单元测试用例
6.5技能验证验证 SKILL.md 的正确性
7E2E 测试生成端到端集成测试

3. 验证生成结果

Section titled “3. 验证生成结果”
Terminal window
# 查看帮助文档
shotcut --help


# 运行测试
pytest tests/


# 实际使用
shotcut open video.mp4 --trim 00:00:10-00:01:00 --output clip.mp4

🔧 常见问题

Section titled “🔧 常见问题”

安装失败怎么办？

Section titled “安装失败怎么办？”
  1. 确认 Python 版本 ≥ 3.10：python --version
  2. 升级 pip：pip install --upgrade pip
  3. 如有权限问题，使用 --user 标志：pip install --user cli-anything-hub

生成的 CLI 不工作？

Section titled “生成的 CLI 不工作？”
  1. 确认目标软件已正确安装
  2. 运行测试检查：pytest tests/
  3. 查看错误日志，通常会在 JSON 输出中提供详细错误信息

如何贡献新的 CLI？

Section titled “如何贡献新的 CLI？”

欢迎贡献！请查看 参与贡献指南。

下一步

Section titled “下一步”