用途：acpx 是 ACP（Agent Client Protocol）的无头 CLI 客户端，专为 agent-to-agent 通信设计，避免 PTY 抓取问题，适合无头运行编码 agent。
主要能力：持久会话（按 repo/cwd 自动恢复）、一次性 exec 执行、并行命名会话（-s/--session）、队列管理（多 prompt 排队，--no-wait 异步提交）、权限控制（--approve-all/--approve-reads/--deny-all）、结构化输出（text/json/quiet）、优雅取消（cancel 或 Ctrl+C 发送 ACP session/cancel）。内置 agent 注册表含 pi、qwen、codex、claude、gemini、cursor、copilot、openclaw、droid、kimi、opencode、kiro、kilocode，默认 codex。
使用方式：安装 npm i -g acpx。基本用法 acpx <agent> '<prompt>'（持久会话）、acpx <agent> exec '<prompt>'（一次性）、acpx <agent> -s <name> '<prompt>'（命名会话）。会话管理有 sessions、sessions new/show/history/close；控制有 cancel、set-mode、set、status。全局选项含 --agent、--cwd、--approve-all、--approve-reads、--deny-all、--format、--timeout、--ttl、--verbose。json 输出为 NDJSON 事件流，quiet 仅输出最终结果。
适用场景：持久仓库助手、并行命名流、队列异步提交、一次性脚本步骤、机器可读输出用于编排、自定义 adapter、指定工作目录。
限制：会话记录存于 ~/.acpx/sessions/*.json；队列通过本地 IPC（Unix 用 ~/.acpx/queues/<hash>.sock，Windows 用命名管道），所有者空闲 TTL 默认 300s。配置合并顺序为全局 ~/.acpx/config.json 后项目 <cwd>/.acpxrc.json。错误含 NO_SESSION、权限被拒绝、超时。具体收费与价格暂未提供。