什么是acpx一文看懂统一操控20 AI编码代理的无头ACP客户端全景图【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpxacpx是一个无头HeadlessACP 命令行客户端让你用一条统一的命令操控 20 款 AI 编码代理Codex、Claude Code、Gemini、Cursor 等。它把有状态的 ACP 会话、一次性任务、权限审批、机器可读输出收敛成同一套接口是自动化流水线里连接 AI 编码代理的终极瑞士军刀 。一、acpx 是什么先讲人话acpx 就是一个AI 编码代理的统一遥控器。过去你每接一个 AI 编码工具Codex、Claude Code、Kiro……就要学一套交互方式想做自动化时很多人只能靠抓取终端输出这种脆弱手段。acpx 基于 Agent Client Protocol (ACP) 这个开放协议直接以结构化 JSON-RPC 与代理对话特性传统做法使用 acpx通信方式抓终端/PTY 文本标准 ACP 协议事件流式输出会话管理每个工具各自为政统一持久会话跨命令恢复上下文并行任务难以实现命名会话多工作流并行自动化输出解析终端转义符--format json输出 NDJSON 事件权限控制不可控批准/拒绝/按工具细分策略核心代码入口在 src/cli.ts 与 src/cli-core.ts内置代理注册表位于 src/agent-registry.ts。二、为什么需要无头 ACP 客户端代理之间要对话acpx 的主用户其实是另一个 AI 或编排器人类可以直接驱动但它是为自动化而生的见 VISION.md。上下文不丢失持久会话让多轮对话跨越进程存活追问时自动恢复上下文。可嵌入npm 包导出acpx/runtime与acpx/flows应用不必重复造轮子直接复用会话存储、队列与生命周期管理。机器可读--format json每行一条 ACP JSON-RPC 消息管道接jq就能做流水线。三、如何一键安装 acpx最快 30 秒上手1️⃣ 要求Node.js 22.13然后全局安装npm install -g acpxlatest2️⃣ 不想全局安装每条命令前加npx acpxlatest即可。3️⃣ 想从源码构建克隆仓库后执行pnpm install与pnpm run buildgit clone https://gitcode.com/gh_mirrors/ac/acpx完整安装细节见 docs/install.md。四、acpx 三步速通教程建会话、发提示、看结果以 Codex 为例其他代理命令形状完全一致acpx codex sessions new # 第1步创建会话 acpx codex 找到最慢的测试并解释原因 # 第2步发送提示 acpx codex 再给出一个一行修复方案 # 第3步上下文自动延续你会看到结构化的事件流助手文本、[tool]工具调用块、计划更新以及最终的[done] end_turn。两个高频技巧一次性任务acpx codex exec 用5句话总结这个仓库—— 不读不写任何保存的会话脚本友好。排队不阻塞上一轮还在跑时acpx codex --no-wait …会把新提示排队到运行中的会话上fire-and-forget。更完整的入门路径参考 docs/quickstart.md。五、如何统一操控 20 AI 编码代理acpx 内置了一份友好的代理注册表25 个预置名字每个都解析为对应的 ACP 适配器命令全部支持同一套命令面prompt/exec/cancel/sessions/status代理调用方式代理调用方式Codexacpx codex …Cursoracpx cursor …Claude Codeacpx claude …GitHub Copilotacpx copilot …Gemini CLIacpx gemini …Devinacpx devin …Kiroacpx kiro …Qwen Codeacpx qwen …Junieacpx junie …Kimiacpx kimi …完整清单见 docs/agents.md每个代理的适配说明放在 agents/ 目录如 agents/Claude.md、agents/Codex.md。隐藏福利——横向对比命令同一个提示词丢给多个代理输出并排摘要acpx compare codex claude gemini 总结这次改动详见 docs/compare.md。自定义代理则用acpx --agent command …配置指南在 docs/custom-agents.md。六、持久会话上下文跨进程存活还能并行开多路会话按(代理命令, 绝对目录, 可选名称)作为作用域键持久化在~/.acpx/下目录内自动恢复在src/子目录发提示会自动恢复仓库根目录创建的会话体验上就像我一直在这个仓库里和 codex 聊天。命名会话并行-s backend修 API、-s docs写发布说明两条工作流互不干扰。完整生命周期sessions子命令支持 list / new / show / history / export / import / prune 等详见 docs/sessions.md 与 docs/session-control.md。七、权限管控与机器可读输出自动化的安全阀ACP 代理在执行写文件、跑命令前会请求权限acpx 用清晰的模式替你裁决标志行为--approve-reads默认模式读/搜索放行其余请求审批--approve-all全部批准适合沙箱环境--deny-all全部拒绝适合只读审查进阶玩法是用--permission-policy做按工具细分的策略autoApprove / autoDeny / escalate规则细节见 docs/permissions.md。输出格式三选一文本默认、quiet只要最终答案、jsonNDJSON 全量 ACP 事件格式说明在 docs/output-formats.md退出码语义见 docs/exit-codes.md。八、Flows把多步 AI 工作流写成 TypeScript 模块当一个提示词不够用时acpx 的 Flows实验性功能登场用 TypeScript 定义工作流混合ACP 对话节点 / shell 动作 / 计算 / 决策 / 检查点运行状态持久化在~/.acpx/flows/runs/每一步可检查、可重放。acpx flow run ./my-flow.ts --input-file ./input.json官方示例包括 PR 分诊流水线可参考 examples/flows/ 与 examples/flows/README.md架构设计文档在 docs/2026-03-25-acpx-flows-architecture.md。若你的应用需要与 CLI 共享同一个本地会话属主可用createSharedAcpRuntime()见 docs/shared-sessions.md。九、项目结构导览核心模块在哪里模块路径职责CLI 入口src/cli.ts命令行解析与分发ACP 客户端src/acp/进程管理、JSON-RPC、错误归一化运行时引擎src/runtime/engine/会话生命周期、回合调度会话持久化src/session/事件日志、队列属主、租约存储Flows 运行时src/flows/工作流定义、执行、存储合规测试conformance/ACP 协议一致性用例与 runner文档体系以 docs/ 为主CLI 参考、提示词指南、配置说明。十、总结一张图记住 acpx一个协议ACP摆脱终端抓取和适配胶水代码一个接口20 AI 编码代理共享同一命令面随时切换、随时对比两种形态既是人类可操作的 CLI也是可嵌入acpx/runtime的会话后端三大场景多轮持久会话、无状态一次性exec、多步 Flows 工作流。acpx 目前处于 1.0 之前接口仍在演进MIT 协议见 LICENSE。如果你想让 CI、编排器或另一个 AI 稳定地指挥一堆编码代理它就是那个完整、简单又免费的统一入口 —— 现在就试试你的第一条acpx命令吧 【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
