☰
CLI-Anything:四步把任意GUI软件变成Agent可调用的CLI工具
2026/10/27 3:10:43 网站建设 项目流程

CLI-Anything:四步把任意GUI软件变成Agent可调用的CLI工具

【免费下载链接】CLI-Anything"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything

如果你写过让AI调GIMP或剪视频的脚本,多半卡在同一处:GUI软件没有稳定接口,Agent只能靠截图和点击。CLI-Anything 把任意开源GUI软件转成Agent可调用的命令行工具,一条/cli-anything命令走完分析、设计、实现、测试到发布的全流程。

项目全景:一条把GUI软件变成Agent CLI的自动化流水线

下图是整条生成链路,从读取源码到产出可pip install的CLI包,七个阶段全部由编码Agent自动完成。

它的做法是"接口化而非重写":CLI生成软件原生格式的项目文件(MLT XML、ODF、SVG),再把渲染导出交给真正的软件后端(libreoffice --headless、blender --background、melt等),所以不损失原始软件的任何能力。产出的每个CLI都同时提供子命令模式和交互式REPL,并内置--json输出供Agent消费。仓库里已为GIMP、Blender、Inkscape、Audacity、LibreOffice等应用生成了生产级CLI,演示表累计统计2,461个测试,全部通过。

5分钟最小可行路径:安装并使用第一个CLI-Anything

先别急着从源码构建,最短路径是直接装一个现成的CLI跑通。CLI-Anything 用cli-anything-hub作为包管理器,一条命令浏览并安装社区已构建好的CLI。

pip install cli-anything-hub

装完后列目录、挑一个(这里选GIMP)安装。要求 Python 3.10+ 和 Click 8.0+。

cli-hub list cli-hub install gimp

跑完之后你应该能看到本地已装入cli-anything-gimp,直接启动即可:

cli-hub launch gimp

它会进入REPL,看到cli-anything-gimp的启动横幅和gimp>提示符,说明第一个用例已经跑通。若选中的CLI依赖真实桌面软件(如GIMP、Blender),还需先装好对应上游应用,否则渲染导出会报错——这是刻意设计,后文"避坑"会再讲。

构建流水线:七个阶段如何产出可安装的CLI

当注册表里还没有你要的软件时,就用生成器从源码构建。完整方法论写在 HARNESS.md,可快速上手流程见 QUICKSTART.md。对Agent只需一条命令:

/cli-anything ./gimp

七个阶段里真正需要你留意的产出物有三类。第一类是设计文档:阶段1、2各产出一份软件专属SOP(<SOFTWARE>.md),把GUI动作映射到后端API、确定命令分组和状态模型。第二类是可运行代码:阶段3在agent-harness/cli_anything/<软件名>/下实现core、utils、基于Click的CLI和REPL。第三类是质量证据:阶段4先写TEST.md测试计划,阶段5实现单元测试(test_core.py,合成数据)和端到端测试(test_full_e2e.py,真实文件+真实后端),阶段6把pytest -v --tb=no结果回填进TEST.md。

阶段6.5还会用skill_generator.py从Click装饰器自动抽出元数据,生成SKILL.md,让CLI能被Agent按技能发现。阶段7生成setup.py并装入PATH。下面这张图是Agent用生成的FreeCAD命令行逐步搭建模型并实时预览的效果,展示"生成后即可驱动真实软件"的能力。

四种接入方式:让 Claude Code 等 Agent 用上同一条命令

不同Agent平台用不同载体载入同一套方法论,但构建命令保持一致,产出的CLI格式也不变。选型按下表,装好后都通过/cli-anything <软件路径>构建、/cli-anything:refine扩覆盖。

平台接入形式安装方式
Claude Code插件(官方,功能最全)/plugin install cli-anything
OpenCode命令文件(实验性)复制opencode-commands/*.md+HARNESS.md到命令目录
Cursor桌面插件脚本bash cursor-plugin/scripts/install.sh
Codex / Reasonix / HermesSKILL.md 安装器bash <skill>/scripts/install.sh
OpenClaw 等SKILL兼容Agent技能文件npx skills add装入skills/下对应SKILL.md

Claude Code 是主推路径,手动安装即把 cli-anything-plugin/ 拷进插件目录后执行/reload-plugins。OpenCode 需要同时复制命令文件和HARNESS.md(命令都引用它),装完得到/cli-anything、/cli-anything-refine、/cli-anything-test、/cli-anything-validate、/cli-anything-list五个命令。技能文件式接入(Codex/Reasonix/Hermes/OpenClaw)则用各自install.sh把自包含技能装进Agent的技能目录,重启即被发现。

进阶技巧:用 refine、JSON 与 REPL 提升产出质量

如果你要补齐某个CLI的能力缺口,用带焦点的 refine,它会做差距分析再增量补命令和测试,可重复执行且不破坏已有内容:

/cli-anything:refine ./obs-studio "scene transitions and streaming profiles"

如果你要把CLI交给脚本或别的Agent调用,给任意命令加--json拿机器可读输出,配合which cli-anything-<软件名>就能被标准发现:

cli-anything-gimp --json project new --width 1920 --height 1080 -o poster.json

如果你要验证CLI确实装进了PATH,用强制安装模式跑测试,它会打印[_resolve_cli] Using installed command: ...确认走的是真实命令而非模块回退,-s还能显示产物路径便于人工检查:

CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/gimp/tests/ -v -s

避坑指南:高频问题的现象、原因与解法

现象:命令报软件未安装。原因:真实后端是硬依赖,CLI不装上游软件就无法渲染。解法:先装上游应用(GIMP/Blender/LibreOffice等),测试失败而非跳过是刻意行为,别加"优雅降级"。

现象:Claude Code 提示Unknown skill: cli-anything。原因:插件没加载,而非命令写法问题。解法:依次执行/reload-plugins、/help cli-anything确认已载入,必要时重装插件,两种入口形式/cli-anything与/cli-anything:cli-anything指向同一技能。

现象:导出"成功"但效果丢失。原因:渲染缺口——简单工具读原始媒体会忽略项目级特效。解法:优先用原生渲染器,或在utils/里建滤镜翻译层(如MLT转ffmpeg -filter_complex),并做魔数/像素级校验,详见 HARNESS.md 的 "The Rendering Gap"。

现象:pip install -e .后命令仍找不到。原因:cli_anything/是PEP 420命名空间包,不应有__init__.py,只有子包才有。解法:确认目录结构符合预期布局,检查$PYTHONPATH。

CLI-Anything 的价值,在于把"任意软件皆可CLI化"做成一条Agent能独立跑完的流水线:从源码到可pip install、带完整测试和技能文件的CLI,一套方法论跨平台通用。想深入,读 完整方法论SOP 掌握七阶段规则,配合 5分钟上手指南 走通第一个harness。

【免费下载链接】CLI-Anything"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询