CLI-Anything 项目介绍

CLI-Anything: Making ALL Software Agent-Native

项目定位

CLI-Anything 是一个自动化流水线，通过 AI Agent 分析任意软件的源码，在 7 个阶段内自动生成生产级的 CLI 接口，使原本仅有人类 GUI 的软件变成 Agent 可直接操作的工具。

一句话定义：用结构化命令行弥合 AI Agent 与世界软件之间的鸿沟——Today’s Software Serves Humans, Tomorrow’s Users will be Agents.

核心能力

7 阶段自动流水线：从代码分析 → 架构设计 → 实现 → 测试计划 → 测试编写 → 文档 → 发布，全程由 Agent 自主完成
真实软件调用原则：生成的 CLI 不做功能重实现，而是生成合法的中间文件（ODF、MLT XML、SVG 等）后调用真实软件进行渲染
双模式交互：每个生成的 CLI 同时支持无状态子命令（脚本/流水线）和有状态 REPL（交互式 Agent 会话）
统一 REPL Skin：所有 CLI 共享一致的终端 UI——横幅、提示符、配色、帮助格式
SKILL.md 自动生成：从 Click 装饰器自动提取元数据，生成 Agent 可发现的技能文件
CLI-Hub 包管理器：社区驱动的 CLI 注册表，支持 pip install cli-anything-hub 后一键浏览、搜索、安装
跨平台插件架构：支持 Claude Code、Codex、OpenCode、Pi、OpenClaw、Qodercli 等多种 AI 编程助手
2330 项测试全覆盖：40+ 软件 Harness，100% 通过率，涵盖单元、E2E、真实后端、CLI 子进程四层测试

技术栈

维度	技术选型
语言	Python 3.10+
CLI 框架	Click ≥ 8.0
测试	pytest（单元 + E2E + 子进程）
包管理	PEP 420 namespace packages
包管理器	click + requests（CLI-Hub）
插件系统	Claude Code Plugin / Codex Skill / OpenCode Commands
协议	MCP（Model Context Protocol）用于部分后端集成
授权	Apache 2.0（核心）/ MIT（CLI-Hub）

架构概览

快速体验

方式一：使用已有 CLI 生态

pip install cli-anything-hub
cli-hub list          # 浏览注册表
cli-hub install gimp  # 安装 GIMP CLI
cli-hub launch gimp   # 启动

方式二：生成新 CLI（以 Claude Code 为例）

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything ./gimp  # 输入任意软件的源码路径或 GitHub URL

生成的 CLI 安装后即可使用：

cd gimp/agent-harness && pip install -e .
cli-anything-gimp --help
cli-anything-gimp               # 进入 REPL 模式
cli-anything-gimp --json ...    # JSON 输出供 Agent 消费

教程导读

CLI-Anything 的教程分为两条路径：

AI 应用通用知识（`ai/`）

从 CLI-Anything 的项目实践出发，提炼 AI 软件工程中的通用设计模式——Agent-Native 软件设计、面向 Agent 的 CLI 接口规范、SKILL.md 技能定义方法论、Preview & Trajectory 渐进式披露等。每条通用知识都与 common/ 目录关联，首次覆盖的知识点会创建独立教程。

编程核心技术（`dev/`）

聚焦 CLI-Anything 自身的工程实践——7 阶段自动流水线的架构、HARNESS.md 方法论、多平台插件系统设计、PEP 420 Namespace Package 分发策略、统一 REPL Skin 系统、四层测试体系、Filter Translation 与 Rendering Gap 等关键技术决策。