anov-dev-copilot-cli

anov-dev-copilot-cli 是 ANOV-DEV Copilot 体系中的命令行脚手架工具。它的主要职责是帮助开发者一键式地将 AI 智能体的核心能力（Skills、Prompts、Rules 等）注入到当前工作区中，并自动配置编辑器中的 MCP (Model Context Protocol) 服务，从而实现与智能体的无缝连接。

🚀 核心功能

• 多别名/命令支持：支持以 anov-dev-copilot-cli、anov-dev-copilot 或 anov-dev-cli 三种命令名执行，满足不同使用习惯。
• 一键交互式配置：提供 setup 命令，实现技能安装与编辑器 MCP 注入的一站式体验。
• 主流 AI 编辑器自动对接：自动检测并写入 Cursor、Claude Code、Antigravity（Gemini Agent）的 MCP 配置文件。
• 独立子命令：可单独运行 setup-skills 注入技能，或 setup-mcp 配置编辑器 MCP。
• 连通性自测：通过 list-version 快速验证 API 地址和 Ticket 是否有效，支持指定目标 Agent 进行精准测试。

📦 安装与运行

1. 免安装直接运行（推荐）

npx anov-dev-copilot-cli setup

2. 全局安装

npm install -g anov-dev-copilot-cli
# 或者使用 pnpm
pnpm add -g anov-dev-copilot-cli

🛠️ 命令详解

1. 一键交互式初始化：setup

setup 是最常用、最核心的命令，它会依次执行 本地 Agent Skills 拷贝 和 编辑器 MCP 注入 两个核心步骤。

anov-dev-copilot setup [options]

支持的参数选项：

| 选项 | 说明 | 默认值 | | :--- | :--- | :--- | | --api-url <url> | ANOV 接口服务的 API Base URL | - | | --ticket <ticket> | 调用 ANOV 接口的 Access Ticket | - | | --yes | 自动配置所有检测到的 AI 编辑器，跳过交互式编辑器选择 | false | | --editors <list> | 逗号分隔的编辑器列表（如 cursor,claude,antigravity） | - | | --with-skills | 同时将 Agent Skills 拷贝到目标项目目录（默认关闭） | false | | --dest <path> | 与 --with-skills 配合使用，指定技能安装目标目录 | . (当前目录) | | --force | 与 --with-skills 配合使用，强制覆盖已有 Skills 文件夹 | false |

[!NOTE] 三大主流 AI 编辑器（Antigravity、Claude Code、Cursor）均支持插件系统，插件安装后 Skills 全局生效。因此 setup 默认只配置 MCP，无需将 Skills 拷贝到项目目录。仅在需要项目级定制化覆盖时，才使用 --with-skills。

交互式配置工作流：

1. （可选）安装本地技能：仅在使用 --with-skills 参数时执行。扫描并将 ANOV 相关的 Agent 技能文件拷贝到 .agents/skills/。
2. 输入 API 配置：如未通过命令行参数指定，CLI 会交互式地要求您输入 API Base URL 以及 Access Ticket。
3. 选择目标编辑器：检测系统上已安装的编辑器配置，并列出选项供您勾选。

2. 仅安装技能：setup-skills

仅为当前项目安装或更新 Agent 技能库，不修改编辑器 MCP 配置：

anov-dev-copilot setup-skills [options]

支持选项：

| 选项 | 说明 | 默认值 | | :--- | :--- | :--- | | --dest <path> | 技能文件输出目录 | . (当前目录) | | --force | 覆盖已有的技能文件夹，无需提示 | false |

3. 仅注入 MCP 配置：setup-mcp

单独更新编辑器的 MCP 服务配置（例如 Ticket 过期需要更新）：

anov-dev-copilot setup-mcp [options]

支持选项：

| 选项 | 说明 | | :--- | :--- | | --api-url <url> | 指定接口 Base URL | | --ticket <ticket> | 指定 Access Ticket | | --yes | 直接为所有检测到的编辑器自动注入配置 | | --editors <list> | 以逗号分隔的指定编辑器（如 cursor,antigravity） |

4. 连通性测试：list-version

测试当前 API 连接是否正常，并清晰地报告使用的是哪个 Agent 的配置。该命令向 /console/v1/devs/demos/v1 接口发起请求并打印结果。

anov-dev-copilot list-version [editor] [options]

支持的参数选项：

| 参数/选项 | 说明 | | :--- | :--- | | [editor] | 可选位置参数，指定要测试哪个 Agent 的全局配置 | | -e, --editor <editor> | 与位置参数等效，用于显式指定目标 Agent |

[editor] 的可用值（大小写不敏感）：

| 值 | 目标 Agent | | :--- | :--- | | cursor | Cursor | | claude、claude-code | Claude Code | | antigravity、gemini、agy | Antigravity |

配置读取优先级：

1. 当提供 [editor] 参数时 → 仅读取指定 Agent 的全局配置文件。
2. 无 [editor] 且工作区存在 .mcp.json 或 mcp_config.json → 优先读取本地工作区配置。
3. 无 [editor] 且无本地配置 → 依次扫描 Cursor → Claude Code → Antigravity 的全局配置，返回第一个有效值。
4. 以上均未命中 → 读取 Shell 环境变量 API_BASE_URL 和 ACCESS_TICKET。

命令示例：

# 自动检测（优先读取本地工作区配置或第一个全局配置）
anov-dev-copilot list-version

# 显式测试 Antigravity 的全局配置
anov-dev-copilot list-version antigravity
anov-dev-copilot list-version -e gemini      # 等价（别名）

# 显式测试 Claude Code 的全局配置
anov-dev-copilot list-version claude
anov-dev-copilot list-version --editor claude-code   # 等价

# 测试 Cursor 的全局配置
anov-dev-copilot list-version cursor

输出示例：

[Test] Config Source  : Global Config File
[Test] Target Agent   : Antigravity
[Test] API Base URL   : http://192.168.11.164:9999
[Test] Access Ticket  : ccdc...0ea6
[Test] Sending request to /console/v1/devs/demos/v1 ...

[Test] Success! Response data:
{ ... }

[!NOTE] 若指定的 [editor] 在本机未找到对应配置，命令将打印错误信息并以退出码 1 退出，方便在脚本中判断连通性。

💻 编辑器 MCP 自动检测与支持

在运行 setup 或 setup-mcp 时，CLI 会自动扫描以下编辑器：

| 编辑器 | 检测方式 | 配置写入路径 | | :--- | :--- | :--- | | Cursor | 检测 ~/.cursor/ 目录是否存在（或 PATH 中的 cursor 命令） | ~/.cursor/mcp.json | | Claude Code | 检测 ~/.claude.json 文件是否存在（或 PATH 中的 claude 命令） | ~/.claude.json | | Antigravity | 检测插件目录是否存在（或 PATH 中的 agy 命令） | ~/.gemini/config/mcp_config.json |

[!NOTE] CLI 优先通过配置文件/目录路径判断编辑器是否安装，若路径不存在则回退到检测 PATH 中的可执行文件（cursor / claude / agy）。配置文件/目录不存在时，CLI 会自动创建。

[!NOTE] Antigravity 写入策略：CLI 直接向全局配置文件 ~/.gemini/config/mcp_config.json 写入 mcpServers 配置，以确保凭证正确注入。

📝 手动配置指引

若 CLI 未能自动识别你的编辑器，可在相应配置文件的 mcpServers 字段下手动添加：

{
  "mcpServers": {
    "anov-dev-copilot": {
      "command": "npx",
      "args": ["-y", "anov-dev-copilot-mcp"],
      "env": {
        "API_BASE_URL": "你的_ANOV_API_BASE_URL",
        "ACCESS_TICKET": "你的_ANOV_ACCESS_TICKET"
      }
    }
  }
}

[!IMPORTANT]

1. 请将 API_BASE_URL 和 ACCESS_TICKET 替换为你在 ANOV 平台上获取的真实有效值。
2. 配置完成后，请务必重启 AI 编辑器或在 MCP 面板中手动重载 (Reload) 该 MCP Server，以使配置生效。

🛠️ 开发与构建

本地代码编译

CLI 项目采用 tsup 进行 TypeScript 编译。构建脚本会在 tsup 打包完成后，自动调用 scripts/copy-skills.js 将工作区根目录的 skills/ 文件夹复制到编译产物 dist/skills/ 目录中。

# 在 packages/cli 目录下执行
pnpm build

热更新开发模式

# 在 packages/cli 目录下执行
pnpm dev

此命令会监视 src/ 下文件的变动并自动重新编译。