一条命令驾驭20+ AI代理：acpx内置代理注册表完整清单（Codex、Claude、Gemini、Cursor）-平芜编程栈

一条命令驾驭20+ AI代理：acpx内置代理注册表完整清单（Codex、Claude、Gemini、Cursor）

【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx

acpx 是一个无头（headless）CLI 客户端，让你用一条统一命令驾驭 20 多个 AI 编程代理：Codex、Claude Code、Gemini CLI、Cursor 等。它通过 Agent Client Protocol（ACP）为所有代理提供持久会话、权限控制和机器可读输出。下面这份内置代理注册表完整清单帮你快速上手。

什么是 acpx？

一句话概括：acpx 把各家 AI 编程代理的命令行接口，统一成一套结构化、可脚本化的 ACP 会话界面。

🚀 安装只需一行：npm install -g acpx@latest（要求 Node.js ≥ 22.13）
📦 会话状态保存在~/.acpx/，跨命令持久存在
🤖 不写脚本也能跑：acpx codex "总结这个仓库"即可

典型体验：

acpx codex sessions new acpx codex "找出最慢的测试并解释原因"

注册表如何工作：友好名称 → 适配器命令

acpx 的核心是一个代理注册表，源码位于 src/agent-registry.ts。每个注册表条目把"友好名称"映射到一条具体的 ACP 适配器命令：

你敲的命令	acpx 实际启动的适配器
`acpx codex …`	`npx -y @agentclientprotocol/codex-acp`
`acpx claude …`	`npx -y @agentclientprotocol/claude-agent-acp`
`acpx gemini …`	`gemini --acp`
`acpx cursor …`	`cursor-agent acp`

几个关键机制（见 agent-registry.ts）：

别名解析：如factory-droid、factorydroid都会解析为droid
包自动获取：pi-acp、codex-acp、claude-agent-acp、kilocode、opencode、mux这些以 npm 包形式提供的适配器，首次使用由npx自动拉取，无需全局安装
默认代理：顶层命令如acpx exec …默认使用codex

26 个内置代理完整清单 📋

这是 acpx 出厂自带的全部代理注册表（源自 docs/agents.md）：

友好名称	适配器命令	对应上游代理
`pi`	`npx pi-acp`	Pi Coding Agent
`openclaw`	`openclaw acp`	OpenClaw ACP 桥接器
`codex`⭐默认	`npx -y @agentclientprotocol/codex-acp`	Codex CLI
`claude`	`npx -y @agentclientprotocol/claude-agent-acp`	Claude Code
`gemini`	`gemini --acp`	Gemini CLI
`cursor`	`cursor-agent acp`	Cursor CLI
`copilot`	`copilot --acp --stdio`	GitHub Copilot CLI
`antigravity`	`agy_acp_server.par`（平台参数）	Google Antigravity
`devin`	`devin acp`	Devin CLI
`droid`	`droid exec --output-format acp`	Factory Droid
`fast-agent`	`uvx fast-agent-mcp acp`	fast-agent
`fx`	`fx acp`	fx
`grok-build`	`grok agent stdio`	Grok Build
`iflow`	`iflow --experimental-acp`	iFlow CLI
`junie`	`junie --acp=true`	JetBrains Junie
`kilocode`	`npx -y @kilocode/cli acp`	Kilocode
`kimi`	`kimi acp`	Kimi CLI
`kiro`	`kiro-cli-chat acp`	Kiro CLI
`mcode`	`mcode acp`	MiniMax Code
`mux`	`mux acp`（acpx 管理的 npm 版本范围）	Mux
`opencode`	`npx -y opencode-ai acp`	OpenCode
`pool`	`pool acp`	Poolside
`qoder`	`qodercli --acp`	Qoder CLI
`qwen`	`qwen --acp`	Qwen Code
`trae`	`traecli acp serve`	Trae CLI
`zeroclaw`	`zeroclaw acp`	ZeroClaw

💡 每个代理还配有独立的设置指南，存放在 agents/ 目录：如 agents/Codex.md、agents/Claude.md、agents/Gemini.md、agents/Cursor.md，包含模型选择、权限拒绝处理等细节。

注意：npm 包形式的适配器（codex、claude、kilocode、opencode、mux、pi）开箱即用；其余"原生 CLI"代理需要你先安装并完成登录（如gemini、cursor-agent）。

统一命令面：所有代理同一套语法

无论你选哪个 AI 代理，命令形态完全一致（见 docs/agents.md）：

acpx <agent> [prompt…] # 隐式提示 acpx <agent> exec [prompt…] # 一次性运行，不保存会话 acpx <agent> sessions [new|list|close|history|prune] acpx <agent> status [-s <name>] # 查看会话状态 acpx <agent> cancel [-s <name>] # 协作式取消

命名会话支持并行工作流：

acpx codex sessions new --name backend acpx claude sessions new --name docs

进阶玩法 🔍

一条 prompt 同时跑多个代理

acpx compare会用同一条 prompt 依次驱动多个 AI 代理并横向对比结果（状态、耗时、token 用量、最终回复），详见 docs/compare.md：

acpx compare pi openclaw codex 'summarize this checkout'

这对"选哪个 AI 代理最合适"的决策场景非常实用。

接入自定义 ACP 代理

注册表不是封闭的，docs/custom-agents.md 提供三种扩展方式：

未知位置名（Unix）：acpx my-agent 'review this patch'，名字本身就是启动命令
--agent逃生舱：acpx --agent 'node ./dev-acp.mjs --port 5555' sessions new
配置定义：在~/.acpx/config.json的agents映射中注册友好名，还能覆盖内置代理，例如把codex指向公司自研适配器