CLI-Anything
一、项目概述
CLI-Anything 是由香港大学数据科学实验室(HKUDS)开发的开源项目,核心目标是让所有软件都能被 AI Agent 原生调用。项目口号:Today's Software Serves Humans 👨💻. Tomorrow's Users will be Agents 🤖
| 项目指标 |
|---|
CLI-Anything 是香港大学数据科学实验室开发的开源项目,旨在通过命令行界面(CLI)让所有软件能被 AI Agent 原生调用。它解决了现有方案 UI 自动化脆弱、缺乏结构化数据等问题。项目采用七阶段全自动流水线生成 CLI,支持 GIMP、Blender 等 9 个生产级软件的集成,提供真实软件调用、零妥协依赖及 Agent 优先设计。通过 Claude Code 插件可快速生成,包含 1436 个测试确保可靠性,愿景是实现通用软件访问与未来就绪生态。
CLI-Anything 是由香港大学数据科学实验室(HKUDS)开发的开源项目,核心目标是让所有软件都能被 AI Agent 原生调用。项目口号:Today's Software Serves Humans 👨💻. Tomorrow's Users will be Agents 🤖
| 项目指标 |
|---|
| 数值 |
|---|
| Stars | 1.1k |
| Forks | 110 |
| Watchers | 7 |
| 主要语言 | Python (99.7%) |
| 测试通过率 | 100% (1,436 tests) |
| 痛点 | 具体表现 |
|---|---|
| AI 无法使用真实工具 | 现有方案要么是脆弱的 UI 自动化,要么是功能阉割的重新实现 |
| UI 自动化不可靠 | 截图、点击、RPA 等方式容易崩溃 |
| Agent 需要结构化数据 | 缺乏标准化的输出格式 |
| 定制集成成本高 | 每个软件都需要单独开发接口 |
| 原型与生产差距大 | 缺乏真实软件验证 |
核心洞察:CLI(命令行界面)是人类和 AI Agent 的通用接口
--help 标志提供自动文档,Agent 可自动发现/cli-anything <software-path-or-repo>
↓ 1. 🔍 Analyze(分析)— 扫描源代码,映射 GUI 动作到 API
2. 📐 Design(设计)— 架构命令组、状态模型、输出格式
3. 🔨 Implement(实现)— 构建 Click CLI,含 REPL、JSON 输出、撤销/重做
4. 📋 Plan Tests(规划测试)— 创建 TEST.md,含单元测试+E2E 测试计划
5. 🧪 Write Tests(编写测试)— 实现全面测试套件
6. 📝 Document(文档)— 更新 TEST.md 结果
7. 📦 Publish(发布)— 创建 setup.py,安装到 PATH
| 原则 | 说明 |
|---|---|
| 真实软件集成 | CLI 必须调用实际应用进行渲染,不是替代而是封装 |
| 灵活交互模式 | 有状态 REPL + 子命令接口,裸命令进入 REPL 模式 |
| 一致用户体验 | 统一 REPL 界面(repl_skin.py),品牌横幅、样式提示、命令历史 |
| Agent 原生设计 | 内置 --json 标志,标准 --help 和 which 命令发现能力 |
| 零妥协依赖 | 真实软件是硬性要求,缺失时测试失败而非跳过 |
| 软件 | 领域 | CLI 命令 | 后端技术 | 测试数 |
|---|---|---|---|---|
| 🎨 GIMP | 图像编辑 | cli-anything-gimp | Pillow + GEGL/Script-Fu | 107 |
| 🧊 Blender | 3D 建模与渲染 | cli-anything-blender | bpy (Python 脚本) | 208 |
| ✏️ Inkscape | 矢量图形 | cli-anything-inkscape | 直接 SVG/XML 操作 | 202 |
| 🎵 Audacity | 音频制作 | cli-anything-audacity | Python wave + sox | 161 |
| 📄 LibreOffice | 办公套件 | cli-anything-libreoffice | ODF 生成 + 无头 LO | 158 |
| 📹 OBS Studio | 直播与录制 | cli-anything-obs-studio | JSON 场景 + obs-websocket | 153 |
| 🎞️ Kdenlive | 视频编辑 | cli-anything-kdenlive | MLT XML + melt 渲染器 | 155 |
| 🎬 Shotcut | 视频编辑 | cli-anything-shotcut | 直接 MLT XML + melt | 154 |
| 📐 Draw.io | 图表绘制 | cli-anything-drawio | mxGraph XML + draw.io CLI | 138 |
| 总计 | 1,436 |
测试构成:1,011 单元测试 + 425 E2E 测试,100% 通过率
# 添加市场 /plugin marketplace add HKUDS/CLI-Anything
# 安装插件 /plugin install cli-anything
# 一键生成 CLI(以 GIMP 为例) /cli-anything ./gimp
git clone https://github.com/HKUDS/CLI-Anything.git
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
/reload-plugins
# 安装到 PATH
cd gimp/agent-harness && pip install -e .
# 查看帮助 cli-anything-gimp --help
# 创建项目 cli-anything-gimp project new --width 1920 --height 1080 -o poster.json
# JSON 模式(供 Agent 使用) cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e"
# 进入交互式 REPL cli-anything-gimp
| 命令 | 功能 |
|---|---|
/cli-anything <path-or-repo> | 完整构建 CLI(全部 7 阶段) |
/cli-anything:refine <path> [focus] | 优化现有 CLI,扩展覆盖范围 |
/cli-anything:test <path-or-repo> | 运行测试并更新 TEST.md |
/cli-anything:validate <path-or-repo> | 按 HARNESS.md 标准验证 |
cli-anything/
├── 📄 README.md / README_CN.md # 中英文档
├── 📁 assets/ # 图标、演示图
├── 🔌 cli-anything-plugin/ # Claude Code 插件
│ ├── HARNESS.md # 方法论 SOP(核心文档)
│ ├── QUICKSTART.md # 5 分钟快速开始
│ ├── PUBLISHING.md # 发布指南
│ ├── repl_skin.py # 统一 REPL 界面
│ └── commands/ # 插件命令定义
│ ├── cli-anything.md
│ ├── refine.md
│ ├── test.md
│ └── validate.md
├── 🎨 gimp/agent-harness/
├── 🧊 blender/agent-harness/
├── ✏️ inkscape/agent-harness/
├── 🎵 audacity/agent-harness/
├── 📄 libreoffice/agent-harness/
├── 📹 obs-studio/agent-harness/
├── 🎞️ kdenlive/agent-harness/
├── 🎬 shotcut/agent-harness/
└── 📐 drawio/agent-harness/
每个 agent-harness/ 包含:
cli_anything.<software>/)repl_skin.py 和后端包装器)HARNESS.md 是项目的标准操作程序(SOP),编码了通过自动化生成流程提炼的成熟模式。
| 教训 | 详细说明 |
|---|---|
| 使用真实软件 | CLI 必须调用实际应用渲染,不能用 Pillow 替代 GIMP,不能用自定义渲染器替代 Blender |
| 渲染差距问题 | GUI 应用在渲染时才应用效果,若 CLI 操作项目文件但使用简单导出工具,效果会被静默丢弃 |
| 滤镜转换 | MLT→ffmpeg 等格式映射时注意:重复滤镜合并、交错流排序、参数空间差异、不可映射效果 |
| 时间码精度 | 非整数帧率(29.97fps)导致累积舍入,用 round() 而非 int(),显示用整数运算,测试容差±1 帧 |
| 输出验证 | 不能因退出码 0 就信任导出成功,需验证:magic bytes、ZIP/OOXML 结构、像素分析、音频 RMS 电平、时长检查 |
| 类别 | 如何 Agent 化 | 典型示例 |
|---|---|---|
| 📂 GitHub 仓库 | 自动 CLI 生成将任何开源项目转为 Agent 可控工具 | VSCodium, WordPress, Calibre, Zotero, Joplin |
| 🤖 AI/ML 平台 | 结构化命令自动化模型训练、推理流程、超参调优 | Stable Diffusion, ComfyUI, InvokeAI, Fooocus |
| 📊 数据分析 | 程序化数据处理、可视化、统计分析工作流 | JupyterLab, Superset, Metabase, DBeaver |
| 💻 开发工具 | 命令接口简化代码编辑、构建、测试、部署 | Jenkins, Gitea, Portainer, SonarQube |
| 🎨 创意媒体 | 程序化控制内容创作、编辑、渲染工作流 | Blender, GIMP, OBS, Krita, Kdenlive |
| 🔬 科学计算 | 自动化研究工作流、仿真、复杂计算 | ImageJ, FreeCAD, QGIS, ParaView, KiCad |
| 🏢 企业办公 | 将业务应用和生产力工具转为 Agent 可访问系统 | NextCloud, GitLab, Grafana, LibreOffice, ERPNext |
| 📐 图表可视化 | 程序化创建和操作图表、流程图、架构图 | Draw.io, Mermaid, PlantUML, Excalidraw |
| ✨ AI 内容生成 | 通过 AI 云 API 生成专业交付物(幻灯片、文档、图表) | AnyGen, Gamma, Beautiful.ai, Tome |

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online