首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >CLI-Anything: 让所有软件都能被 Agent 驱动

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

作者头像
山行AI
发布2026-04-09 21:06:01
发布2026-04-09 21:06:01
2530
举报

前言

📊 典型应用场景

CLI-Anything 的通用性极强,对于构建复杂的数据流转和自动化调度系统尤为有价值:

1.数据与分析流水线:能够将 JupyterLab、Apache Superset 或各类 BI 工具转化为 Agent 可控的节点,以编程方式自动化数据处理和可视化图表生成。2.AI/ML 平台与开发工具:可以通过结构化命令驱动模型训练、推理流程,或串联 CI/CD 开发部署工具,极大提升研发与数据流转的自动化效率。3.日常办公与创意工作:接管复杂的 3D 渲染、视频剪辑、文档生成或会议调度等任务。

⚠️ 使用前提与局限 强模型依赖:构建过程高度依赖前沿级别的大语言模型(如 Claude Opus 4.6 等)来保证代码分析与生成的可靠性。

源码依赖:目标软件必须提供可访问的源代码,纯编译后的二进制文件会导致生成质量显著下降。

🤔 为什么是 CLI?

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

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

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

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

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

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

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

🚀 快速上手

环境要求

Python 3.10+•目标软件已安装(如 GIMP、Blender、LibreOffice 或你自己的应用)•支持的 AI 编程工具之一:Claude Code[1] | OpenClaw[2] | OpenCode[3] | Codex[4] | Qodercli[5] | 更多平台[6]

选择你的平台

⚡ Claude Code

第一步:添加插件市场

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

代码语言:javascript
复制
# 添加 CLI-Anything 插件市场
/plugin marketplace add HKUDS/CLI-Anything

第二步:安装插件

代码语言:javascript
复制
# 从市场安装 cli-anything 插件
/plugin install cli-anything

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

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

第三步:一行命令生成 CLI

代码语言:javascript
复制
# /cli-anything:cli-anything <软件路径或仓库地址>
# 为 GIMP 生成完整的 CLI(7 个阶段全自动)
/cli-anything:cli-anything ./gimp

# 注意:如果你的 Claude Code 版本低于 2.x,请使用 "/cli-anything"。

完整流水线自动执行:

1.🔍 分析 — 扫描源码,将 GUI 操作映射到 API2.📐 设计 — 规划命令分组、状态模型、输出格式3.🔨 实现 — 构建 Click CLI,包含 REPL、JSON 输出、撤销/重做4.📋 规划测试 — 生成 TEST.md,涵盖单元测试和端到端测试计划5.🧪 编写测试 — 实现完整测试套件6.📝 文档 — 更新 TEST.md,写入测试结果7.📦 发布 — 生成 setup.py,安装到 PATH

第四步(可选):优化和扩展 CLI

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

代码语言:javascript
复制
# 全面优化 — Agent 分析所有功能的覆盖差距
/cli-anything:refine ./gimp

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

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

备选方案:手动安装

如果你不想用插件市场:

代码语言:javascript
复制
# 克隆仓库
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 命令目录:

代码语言:javascript
复制
# 克隆仓库
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/

注意: HARNESS.md 是所有命令引用的方法论规范,必须和命令文件放在同一目录下。

安装后获得 5 个斜杠命令:/cli-anything/cli-anything-refine/cli-anything-test/cli-anything-validate/cli-anything-list

第二步:一行命令生成 CLI

代码语言:javascript
复制
# 为 GIMP 生成完整的 CLI(7 个阶段全自动)
/cli-anything ./gimp

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

命令以子任务方式运行,遵循与 Claude Code 相同的 7 阶段方法论。

第三步(可选):优化和扩展 CLI

代码语言:javascript
复制
# 全面优化 — Agent 分析所有功能的覆盖差距
/cli-anything-refine ./gimp

# 定向优化 — 指定特定功能领域
/cli-anything-refine ./gimp "批处理和滤镜"
⚡ Qodercli 社区贡献

第一步:注册插件

代码语言:javascript
复制
git clone https://github.com/HKUDS/CLI-Anything.git
bash CLI-Anything/qoder-plugin/setup-qodercli.sh

脚本会将 cli-anything 插件注册到 ~/.qoder.json。注册后开启新的 Qodercli 会话即可使用。

第二步:在 Qodercli 中使用 CLI-Anything

代码语言:javascript
复制
/cli-anything:cli-anything ./gimp
/cli-anything:refine ./gimp "批处理和滤镜"
/cli-anything:validate ./gimp
⚡ OpenClaw

第一步:安装 Skill

CLI-Anything 提供了原生的 OpenClaw SKILL.md 文件。请将其复制到你的 OpenClaw 技能目录:

代码语言:javascript
复制
# Clone the repo
git clone https://github.com/HKUDS/CLI-Anything.git

# Install to the global skills folder
mkdir -p ~/.openclaw/skills/cli-anything
cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md

第二步:构建 CLI

安装完成后,你就可以在 OpenClaw 中直接调用:

@cli-anything build a CLI for ./gimp

该技能采用了与 Claude Code 和 OpenCode 一致的 7 步构建流程。

⚡ Codex 实验性 社区贡献

第一步:安装 Skill

运行仓库内置的安装脚本:

代码语言:javascript
复制
# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

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

在 Windows PowerShell 中,可以使用:

代码语言:javascript
复制
.\CLI-Anything\codex-skill\scripts\install.ps1

脚本会把 skill 安装到 $CODEX_HOME/skills/cli-anything;如果没有设置 CODEX_HOME,则默认安装到 ~/.codex/skills/cli-anything

安装后重启 Codex,让它重新发现这个 skill。

第二步:在 Codex 里使用 CLI-Anything

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

代码语言:javascript
复制
Use CLI-Anything to build a harness for./gimp
Use CLI-Anything to refine ./shotcut for picture-in-picture workflows
Use CLI-Anything to validate ./libreoffice

这个 Codex skill 复用了 Claude Code 插件和 OpenCode 命令所使用的同一套方法论, 不会改变生成出来的 Python harness 结构。

🔮 更多平台(即将支持)

CLI-Anything 的设计是平台无关的,计划支持更多 AI 编程工具:

Codex — 已通过 codex-skill/ 提供接入•Cursor — 即将支持•Windsurf — 即将支持•你喜欢的工具 — 欢迎贡献!参考 opencode-commands/ 目录的实现。

开始使用生成的 CLI

无论你用哪个平台构建,生成的 CLI 使用方式完全一样:

代码语言:javascript
复制
# 安装到 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

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

• 🌐 无门槛接入 - 任何软件都能通过结构化 CLI 即刻被 Agent 操控。

• 🔗 无缝集成 - 不需要专门的 API、不需要操控 GUI、不需要重构代码,也不需要复杂的适配层。

• 🚀 面向未来 - 一条命令,就能把为人类设计的软件变成 Agent 的原生工具。


🔧 适用场景

类别

如何接入 Agent

典型软件

📂 GitHub 开源项目

通过自动 CLI 生成,将任意开源项目变成 Agent 可控的工具

VSCodium、WordPress、Calibre、Zotero、Joplin、Logseq、Penpot、Super Productivity

🤖 AI/ML 平台

用结构化命令驱动模型训练、推理流水线和超参搜索

Stable Diffusion WebUI、ComfyUI、InvokeAI、Text-generation-webui、Open WebUI、Fooocus、Kohya_ss、AnythingLLM、SillyTavern

📊 数据与分析

以编程方式完成数据处理、可视化和统计分析工作流

JupyterLab、Apache Superset、Metabase、Redash、DBeaver、KNIME、Orange、OpenSearch Dashboards、Lightdash

💻 开发工具

通过命令行接口串联代码编辑、构建、测试和部署流程

Jenkins、Gitea、Hoppscotch、Portainer、pgAdmin、SonarQube、ArgoCD、OpenLens、Insomnia、Beekeeper Studio

🎨 创意与媒体

以编程方式控制内容创作、编辑和渲染工作流

Blender、GIMP、OBS Studio、Audacity、Krita、Kdenlive、Shotcut、Inkscape、Darktable、LMMS、Ardour

📐 图表与可视化

以编程方式创建和操作流程图、架构图、ER 图等各类图表

Draw.io (diagrams.net)、Mermaid、PlantUML、Excalidraw、yEd

🔬 科学计算

自动化科研工作流、仿真模拟和复杂计算

ImageJ、FreeCAD、QGIS、ParaView、Gephi、LibreCAD、Stellarium、KiCad、JASP、Jamovi

🏢 企业与办公

将商业应用和生产力工具转化为 Agent 可访问的系统

NextCloud、GitLab、Grafana、Mattermost、LibreOffice、AppFlowy、NocoDB、Odoo (Community)、Plane、ERPNext

📞 通信与协作

通过结构化 CLI 自动化会议调度、参会人管理、录制获取和报告生成

Zoom、Jitsi Meet、BigBlueButton、Mattermost


CLI-Anything 的核心优势

Agent 与软件之间的鸿沟

AI Agent 推理能力很强,但操控真实专业软件的能力很弱。现有方案要么是脆弱的 GUI 自动化,要么是覆盖面有限的 API,要么是阉割了 90% 功能的重新实现。

CLI-Anything 的解法:把任何专业软件变成 Agent 原生工具,功能一个不少。

现有痛点

CLI-Anything 怎么解

🤖 "AI 用不了真正的专业工具"

直接对接真实软件后端(Blender、LibreOffice、FFmpeg)—— 完整的专业能力,零妥协

💸 "GUI 自动化三天两头崩"

告别截图、点击和 RPA 的脆弱性,纯命令行操控,结构化接口

📊 "Agent 需要结构化数据"

内置 JSON 输出供 Agent 直接消费,同时保留可读格式方便调试

🔧 "定制集成太贵了"

一个插件就能为任意代码库自动生成 CLI,经过验证的 7 阶段流水线

⚡ "原型和生产之间差十万八千里"

1,508+ 测试用例,全部在真实软件上验证通过,覆盖 11 款主流应用


🎯 CLI-Anything 能做什么?

🛠️ 让 Agent 接管你的工作流不管是专业场景还是日常事务 —— 把代码库扔给 /cli-anything 就行。GIMP、Blender、Shotcut 搞创作,LibreOffice、OBS Studio 干日常。没有源码?找个开源替代品,照样能用。你会立刻得到一套 Agent 可以直接调用的完整 CLI。

🔗 把散装 API 统一成一个 CLI受够了一堆零碎的 Web 服务 API?把文档或 SDK 手册喂给 /cli-anything,你的 Agent 就能拿到一个有状态的、功能完整的 CLI,把那些零散的接口整合成逻辑清晰的命令组。一个工具顶替几十个裸 API 调用 —— 能力更强,token 更省。

🚀 取代 GUI Agent,或让它更强CLI-Anything 可以直接替代基于 GUI 的 Agent 方案 —— 不再截图,不再脆弱地点像素。更有意思的是:一旦你对 GUI 软件跑过 /cli-anything,就能全自动地合成 Agent 任务、评测器和 Benchmark —— 纯代码和终端操作,支持迭代优化,效率拉满。


✨ ⚙️ CLI-Anything 的工作方式

代码语言:javascript
复制
🎯 真实软件集成
直接调用真实应用进行渲染。LibreOffice 生成 PDF,Blender 渲染 3D 场景,Audacity 通过 sox 处理音频。零妥协,零玩具实现。

🎬 实测展示

🎯 通用性

CLI-Anything 适用于任何有代码库的软件 —— 不限领域,不限架构。

🏭 专业级测试

在 11 款复杂应用上进行了实测,涵盖创意、生产力、通信、图表和 AI 内容生成领域 —— 这些软件此前对 AI Agent 来说几乎不可触及。

🎨 覆盖多元领域

从创意工作流(图像编辑、3D 建模、矢量图形)到生产工具(音频、办公、直播、视频剪辑)。

✅ 完整的 CLI 生成

每款软件都生成了完整的、可投产的 CLI 接口 —— 不是 demo,而是保留全部功能的完整工具接入。

软件

领域

CLI 命令

后端

测试

🎨 GIMP

图像编辑

cli-anything-gimp

Pillow + GEGL/Script-Fu

✅ 107

🧊 Blender

3D 建模与渲染

cli-anything-blender

bpy (Python scripting)

✅ 208

✏️ Inkscape

矢量图形

cli-anything-inkscape

Direct SVG/XML manipulation

✅ 202

🎵 Audacity

音频制作

cli-anything-audacity

Python wave + sox

✅ 161

📄 LibreOffice

办公套件(Writer、Calc、Impress)

cli-anything-libreoffice

ODF generation + headless LO

✅ 158

📹 OBS Studio

直播与录制

cli-anything-obs-studio

JSON scene + obs-websocket

✅ 153

🎞️ Kdenlive

视频剪辑

cli-anything-kdenlive

MLT XML + melt renderer

✅ 155

🎬 Shotcut

视频剪辑

cli-anything-shotcut

Direct MLT XML + melt

✅ 154

📞 Zoom

视频会议

cli-anything-zoom

Zoom REST API (OAuth2)

✅ 22

📐 Draw.io

图表绘制

cli-anything-drawio

mxGraph XML + draw.io CLI

✅ 138

✨ AnyGen

AI 内容生成

cli-anything-anygen

AnyGen REST API (anygen.io)

✅ 50

合计

✅ 1,508

全部 1,508 项测试 100% 通过 —— 1,073 项单元测试 + 435 项端到端测试。


📊 测试结果

每个 CLI 都经过多层严格测试,确保生产可用:

测试层级

测什么

示例

单元测试

每个核心函数的隔离验证,使用合成数据

test_core.py — 项目创建、图层操作、滤镜参数

端到端测试(原生)

项目文件的完整生成流程

ODF ZIP 结构合法性、MLT XML 正确性、SVG 格式完整性

端到端测试(真实后端)

调用真实软件并验证输出

LibreOffice → 含 %PDF- 魔术字节的 PDF,Blender → 渲染后的 PNG

CLI 子进程测试

通过 subprocess.run 调用已安装命令

cli-anything-gimp --json project new → 合法 JSON 输出

代码语言:javascript
复制
================================TestSummary================================
gimp          107 passed  ✅(64 unit +43 e2e)
blender       208 passed  ✅(150 unit +58 e2e)
inkscape      202 passed  ✅(148 unit +54 e2e)
audacity      161 passed  ✅(107 unit +54 e2e)
libreoffice   158 passed  ✅(89 unit +69 e2e)
obs-studio    153 passed  ✅(116 unit +37 e2e)
kdenlive      155 passed  ✅(111 unit +44 e2e)
shotcut       154 passed  ✅(110 unit +44 e2e)
zoom           22 passed  ✅(22 unit +0 e2e)
drawio        138 passed  ✅(116 unit +22 e2e)
anygen         50 passed  ✅(40 unit +10 e2e)
──────────────────────────────────────────────────────────────────────────────
TOTAL        1,508 passed  ✅100%pass rate

🏗️ CLI-Anything 的架构

🎯 核心设计原则

1.真实软件集成 — CLI 生成合法的项目文件(ODF、MLT XML、SVG),然后交给真实应用去渲染。我们做的是软件的结构化接口,而不是替代品。2.灵活的交互模式 — 每个 CLI 都支持两种模式:有状态的 REPL 用于 Agent 交互会话,子命令模式用于脚本和流水线。直接运行命令即进入 REPL。3.一致的使用体验 — 所有生成的 CLI 共享统一的 REPL 界面(repl_skin.py),带有品牌横幅、风格化提示符、命令历史、进度指示器和标准化格式。4.Agent 原生设计 — 每个命令内置 --json 参数,输出结构化数据供 Agent 消费,同时可读的表格格式服务于交互调试。Agent 通过标准的 --helpwhich 命令发现能力。5.零妥协的依赖策略 — 真实软件是硬性要求 —— 没有兜底,没有降级。后端缺失时测试直接失败(而非跳过),确保功能的真实性


📂 项目结构

代码语言:javascript
复制
cli-anything/
├──📄 README.md                          # 英文文档
├──📄 README_CN.md                       # 中文文档(你在这里)
├──📁 assets/# 图片和媒体文件
│├── icon.png                          # 项目图标
│└── teaser.png                        # 概览图
│
├──🔌 cli-anything-plugin/# Claude Code 插件
│├── HARNESS.md                        # 方法论 SOP(唯一权威来源)
│├── README.md                         # 插件文档
│├── QUICKSTART.md                     # 5 分钟快速上手
│├── PUBLISHING.md                     # 分发与发布指南
│├── repl_skin.py                      # 统一 REPL 界面
│├── commands/# 插件命令定义
││├── cli-anything.md               # 主构建命令
││├── refine.md                     # 扩展已有 harness 覆盖面
││├── test.md                       # 测试运行器
││├── validate.md                   # 标准验证
││└── list.md                       # 列出所有 CLI 工具
│└── scripts/
│└── setup-cli-anything.sh         # 安装脚本
│
├──📋 opencode-commands/# OpenCode 命令
│├── cli-anything.md                  # 主构建命令
│├── cli-anything-refine.md           # 优化扩展命令
│├── cli-anything-test.md             # 测试运行器
│├── cli-anything-validate.md         # 标准验证
│└── cli-anything-list.md             # 列出所有 CLI 工具
│
├──🤖 codex-skill/# Codex skill 接入层
├──🎨 gimp/agent-harness/# GIMP CLI(107 项测试)
├──🧊 blender/agent-harness/# Blender CLI(208 项测试)
├──✏️ inkscape/agent-harness/# Inkscape CLI(202 项测试)
├──🎵 audacity/agent-harness/# Audacity CLI(161 项测试)
├──📄 libreoffice/agent-harness/# LibreOffice CLI(158 项测试)
├──📹 obs-studio/agent-harness/# OBS Studio CLI(153 项测试)
├──🎞️ kdenlive/agent-harness/# Kdenlive CLI(155 项测试)
├──🎬 shotcut/agent-harness/# Shotcut CLI(154 项测试)
├──📞 zoom/agent-harness/# Zoom CLI(22 项测试)
├──📐 drawio/agent-harness/# Draw.io CLI(138 项测试)
└──✨ anygen/agent-harness/# AnyGen CLI(50 项测试)

每个 agent-harness/ 包含一个可安装的 Python 包,位于 cli_anything.<软件名>/ 下,包含 Click CLI、核心模块、工具类(含 repl_skin.py 和后端适配器)以及完整的测试。


🎯 插件命令

代码语言:javascript
复制
说明

使用示例

代码语言:javascript
复制
# 从本地源码为 GIMP 构建完整 CLI
/cli-anything /home/user/gimp

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

# 优化已有的 CLI —— 全面差距分析
/cli-anything:refine /home/user/gimp

# 带聚焦方向的优化
/cli-anything:refine /home/user/shotcut "画中画和视频叠加合成"

# 运行测试并更新 TEST.md
/cli-anything:test /home/user/inkscape

# 按照 HARNESS.md 标准验证
/cli-anything:validate /home/user/audacity

🎮 实际操作演示

cli-anything-libreoffice 为例,看看 Agent 能做什么:

代码语言:javascript
复制
# 创建一个 Writer 文档
$ cli-anything-libreoffice document new-o report.json --type writer
✓CreatedWriter document: report.json

# 添加内容
$ cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report"--level 1
✓Added heading:"Q1 Report"

$ cli-anything-libreoffice --project report.json writer add-table --rows 4--cols 3
✓Added4×3 table

# 通过 LibreOffice headless 导出为真实 PDF
$ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite
✓Exported: output.pdf (42,831 bytes) via libreoffice-headless

# JSON 模式供 Agent 消费
$ cli-anything-libreoffice --json document info --project report.json
{
"name":"Q1 Report",
"type":"writer",
"pages":1,
"elements":2,
"modified":true
}

REPL 模式

代码语言:javascript
复制
$ cli-anything-blender
╔══════════════════════════════════════════╗
║       cli-anything-blender v1.0.0║
║Blender CLI for AI Agents║
╚══════════════════════════════════════════╝

blender> scene new--name ProductShot
✓Created scene:ProductShot

blender[ProductShot]>object add-mesh --type cube --location 001
✓Added mesh:Cube at (0,0,1)

blender[ProductShot]*> render execute --output render.png --engine CYCLES
✓Rendered: render.png (1920×1080,2.3 MB) via blender --background

blender[ProductShot]>exit
Goodbye!👋

📖 标准手册:HARNESS.md

HARNESS.md 是我们通过自动化 CLI 生成让任意软件变得 Agent 可用的权威 SOP。

它记录了在自动化生成过程中验证和沉淀下来的模式与方法论。

这本手册提炼了成功构建全部 11 套生产级 CLI 的关键经验。

核心经验

代码语言:javascript
复制
说明

完整方法论见:cli-anything-plugin/HARNESS.md[7]


📦 安装与使用

Claude Code 用户

代码语言:javascript
复制
# 添加市场并安装(推荐)
/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

# 为任何有代码库的软件生成 CLI
/cli-anything:cli-anything <软件路径或仓库>

OpenCode 用户

代码语言:javascript
复制
# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 请确保使用最新 OpenCode,旧版本可能使用不同的命令目录路径
# 复制命令和 HARNESS.md 到 OpenCode 命令目录
cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/

# 为任何有代码库的软件生成 CLI
/cli-anything <软件路径或仓库>

使用生成的 CLI

代码语言:javascript
复制
# 安装任意生成的 CLI
cd <软件名>/agent-harness
pip install -e .

# 验证安装
which cli-anything-<软件名>

# 开始使用
cli-anything-<软件名>--help
cli-anything-<软件名># 进入 REPL
cli-anything-<软件名>--json <命令># JSON 输出供 Agent 使用

运行测试

代码语言:javascript
复制
# 运行某个 CLI 的测试
cd <软件名>/agent-harness
python3 -m pytest cli_anything/<软件名>/tests/-v

# 强制安装模式(推荐用于验证)
CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<软件名>/tests/-v -s

🤝 参与贡献

欢迎贡献!CLI-Anything 天然支持扩展:

新的目标软件 — 用插件为任意有代码库的软件生成 CLI,然后通过 cli-anything-plugin/PUBLISHING.md[8] 提交你的成果。•方法论改进 — 向 HARNESS.md 提 PR,把新的经验教训沉淀下来•插件增强 — 新命令、阶段优化、更好的验证逻辑•测试覆盖 — 更多端到端场景、边界情况、工作流测试

已知局限

依赖强大的基础模型 — CLI-Anything 依赖前沿级别的模型(如 Claude Opus 4.6、Claude Sonnet 4.6、GPT-5.4)才能可靠地生成 harness。较弱或较小的模型可能产出不完整或有误的 CLI,需要大量人工修正。•依赖可用的源代码/cli-anything 基于源码进行分析和生成。如果目标软件只提供编译后的二进制文件,需要反编译才能获取代码,harness 的质量和覆盖率会显著下降。•可能需要迭代优化 — 单次 /cli-anything 运行不一定能完整覆盖所有功能。通常需要执行一次或多次 /refine 命令,才能将 CLI 的性能和覆盖率推到生产级水平。


📖 文档

文档

说明

cli-anything-plugin/HARNESS.md[9]

方法论 SOP — 唯一权威来源

cli-anything-plugin/README.md[10]

插件文档 — 命令、选项、阶段

cli-anything-plugin/QUICKSTART.md[11]

5 分钟快速上手

cli-anything-plugin/PUBLISHING.md[12]

分发与发布指南

每个生成的 CLI 还包含:

<软件名>.md — 该应用的架构 SOP•tests/TEST.md — 测试计划和结果文档


⭐ Star History

如果 CLI-Anything 帮到了你,给个 Star 吧!⭐


📄 License

MIT License — 可自由使用、修改和分发。


CLI-Anything

一行命令,让任何软件成为 Agent 的原生工具。

References

[1] Claude Code:#-claude-code [2]OpenClaw:#-openclaw [3]OpenCode:#-opencode [4]Codex:#-codex [5]Qodercli:#-qodercli [6]更多平台:#-更多平台即将支持 [7]cli-anything-plugin/HARNESS.md:cli-anything-plugin/HARNESS.md [8]cli-anything-plugin/PUBLISHING.md:cli-anything-plugin/PUBLISHING.md [9]cli-anything-plugin/HARNESS.md:cli-anything-plugin/HARNESS.md [10]cli-anything-plugin/README.md:cli-anything-plugin/README.md [11]cli-anything-plugin/QUICKSTART.md:cli-anything-plugin/QUICKSTART.md [12]cli-anything-plugin/PUBLISHING.md: cli-anything-plugin/PUBLISHING.md

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2026-03-18,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 山行AI 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
    • 📊 典型应用场景
    • 🤔 为什么是 CLI?
    • 🚀 快速上手
      • 环境要求
      • 选择你的平台
      • 开始使用生成的 CLI
    • 💡 CLI-Anything 的愿景:构建 Agent 原生的软件生态
    • 🔧 适用场景
    • CLI-Anything 的核心优势
      • Agent 与软件之间的鸿沟
    • 🎯 CLI-Anything 能做什么?
    • ✨ ⚙️ CLI-Anything 的工作方式
    • 🎬 实测展示
      • 🎯 通用性
      • 🏭 专业级测试
      • 🎨 覆盖多元领域
      • ✅ 完整的 CLI 生成
    • 📊 测试结果
    • 🏗️ CLI-Anything 的架构
      • 🎯 核心设计原则
    • 📂 项目结构
    • 🎯 插件命令
      • 使用示例
    • 🎮 实际操作演示
      • REPL 模式
    • 📖 标准手册:HARNESS.md
      • 核心经验
    • 📦 安装与使用
      • Claude Code 用户
      • OpenCode 用户
      • 使用生成的 CLI
      • 运行测试
    • 🤝 参与贡献
      • 已知局限
    • 📖 文档
    • ⭐ Star History
    • 📄 License
      • References
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档