文档 / MCP 与 ACP

Kiro、Codex 与 Antigravity

Yuli 同时作为 ACP 客户端和 MCP 服务器,让你在 IDE 中使用自己的 Kiro、Codex 或 Antigravity。

除了 Claude Code,Yuli 还支持 Kiro、Codex 和 Antigravity,每个都使用你自己的账户。对它们而言,Yuli 既是一个 ACP 客户端(Agent Client Protocol),与其他 IDE 一样,同时也是它们的 MCP 服务器。

通道 用途
ACP Yuli 发送你的需求,并实时接收回复、推理过程、权限请求和计划。
MCP 智能体使用 yuli_* 工具:构建、测试、验证、质量、数据库、Web Studio……

每个智能体都有自己的对话、任务和更改窗口。切换智能体绝不会混淆各自的状态。

选择智能体

在聊天上方的 你和谁一起工作? 选择器中,“你的订阅 · 你的账户”分组:

智能体 账户
Claude Code 你的 Claude 账户(Pro、Max 或 Console)。参见 Claude Code。
Kiro 你的 AWS Builder ID、Google 或 GitHub 账户。
Codex 你的 ChatGPT 账户。
Antigravity 你的 Google 账户。

Yuli 从不下载或再分发这些智能体:它只检测你已安装的那个。

Kiro

步骤 说明
安装 如果缺失,会显示 “安装 Kiro CLI 以在此使用”,并附带 kiro.dev/cli 链接和官方命令。需要 1.28.2 或更高版本。
提示 “开始使用 Kiro 之前”:Kiro 使用你的账户和额度,它读取的代码会依据你的条款发送至 AWS。
登录 登录 会在 Yuli 的终端中打开 kiro-cli login。对于远程机器,使用 使用设备代码。
规则 位于 .kiro/steering/yuli.md 和流程文件中;如果配置保存在项目之外,则随第一个需求一起发送。

Yuli 通过 kiro-cli acp 启动 Kiro,由 CLI 自身完成认证。令牌保留在 Kiro 中。

Codex

步骤 说明
安装 npm install -g @openai/codex @agentclientprotocol/codex-acp。Yuli 使用官方 ACP 适配器 codex-acp;如果只找到 codex,会提示你缺少适配器。
提示 “开始使用 Codex 之前”。
登录 在 Yuli 的终端中运行 codex login,或使用设备代码。
规则 位于 AGENTS.md 的受管理区块中;如果配置保存在项目之外,则随第一个需求一起发送。

Antigravity

步骤 说明
安装 下载 Google 发布的 Antigravity ACP 服务器,并解压到 ~/.antigravity/acp/。
提示 “开始使用 Antigravity 之前”。
登录 没有登录用的 CLI:服务器会在浏览器中打开 Google 页面,会话会自动建立。
规则 位于 .agent/rules/yuli.md;如果配置保存在项目之外,则随第一个需求一起发送。

Google 指出,使用非官方工具访问 Antigravity 可能违反其条款。Yuli 会在事前提示中说明这一点。使用前请先阅读相关条款。

使用 ACP 智能体工作

  • 采用 Yuli 设计的对话界面:边写边显示的回复、可折叠的推理过程、以时间线呈现的工具调用、计划、已更改的文件和验证结果。
  • 输入框:Enter 发送,Shift+Enter 换行,@ 提及文件,/ 显示智能体公布的命令。
  • 队列:如果智能体正在工作,你发送的内容会进入队列。停止(或 Esc)取消本轮。
  • 模型、强度和模式:使用智能体自身公布的列表。
  • 历史记录:打开之前的会话或开始新会话。
  • 权限:每个请求都以 Yuli 卡片的形式呈现,选项与智能体提供的完全一致。Yuli 绝不会编造选项,也不会替你作答。

完成标准

这些智能体没有可以阻止结束本轮的 hook,因此 Yuli 以客户端身份执行这一标准:如果本轮修改了代码,而验证或度量未通过,它会发送一条简短的自动跟进消息,说明还缺什么。

  • 它在对话中显示为 Yuli 的消息。
  • 有次数上限(默认 3 次),并且由于会消耗你的额度,你可以通过 自动跟进 关闭它。
  • 如果与智能体的连接中断,Yuli 绝不会自行重新发送任何内容。

相同的规则

仅在你要求时使用 Git、CI 和 DevOps;仅在你要求时创建分支;机密受到保护;结构和命名受到检查;项目 hooks 生效。与 Claude Code 完全相同。

其他智能体:仅导出规则

Gemini CLI、Cursor 和 GitHub Copilot 不在 Yuli 内部运行。不过你可以为它们提供相同的项目规则:在治理中心的 智能体 → 上下文 中,导出到 GEMINI.md、.cursor/rules/yuli.mdc 和 .github/copilot-instructions.md。参见 Gate 与治理中心。