用途：acpx 是面向 ACP（Agent Client Protocol）的无头、可脚本化 CLI 客户端，用于智能体到智能体的自动化，无需 PTY 抓取。适合通过脚本驱动编码智能体、管理持久 ACP 会话、排队提示，或消费结构化输出；尤其用于 wave-planner-acpx 获批后的 Wave-Driven Development 执行。
主要能力：按仓库/cwd 的持久多轮会话；一次性执行模式（exec）；命名并行会话（-s/--session）；带可选 fire-and-forget（--no-wait）的队列感知提示提交；对进行中轮次的协作式取消（cancel）；会话控制（set-mode、set <key> <value>）；会话元数据/历史查看（sessions show、sessions history）；本地智能体进程检查（status）；结构化输出（text、json、quiet）；--suppress-reads 精简编排输出；--prompt-retries 重试瞬时提示失败；通过 ACP session/set_model 的通用模型选择；Codex 会话的 --model 支持；v0.4.0 的实验性 flows 运行时与回放相关工具。
安装与用法：npm i -g acpx（建议全局安装而非 npx，以稳定复用会话）。prompt 为默认命令。基本形式：acpx [global_options] [prompt_text...]；acpx [global_options] exec [prompt_options] [prompt_text...]；acpx [global_options] cancel [-s <name>]；acpx [global_options] set-mode <mode> [-s <name>]；acpx [global_options] set <key> <value> [-s <name>]；acpx [global_options] status [-s <name>]；acpx [global_options] sessions [list | new [--name <name>] | close [name] | show [name] | history [name] [--limit <count>]]；acpx [global_options] config [show | init]；acpx [global_options] <agent> [prompt_options] [prompt_text...]。内置智能体注册：codex -> npx @zed-industries/codex-acp；claude -> npx @zed-industries/claude-agent-acp；gemini -> gemini；opencode -> npx opencode-ai；pi -> npx pi-acp；qoder -> qodercli --acp；trae -> traecli acp serve。默认智能体为 codex；未知位置智能体标记按原始命令处理；--agent <command> 为显式原始命令模式；不要将位置智能体标记与 --agent 组合。
全局选项：--agent、--cwd、--approve-all、--approve-reads、--deny-all、--model、--format、--suppress-reads、--prompt-retries、--timeout、--ttl、--verbose；权限标志互斥。会话按 agentCommand、绝对 cwd、可选会话名限定；更改 cwd 会改变会话范围。
适用场景与限制：适合并行命名流、仓库范围审查、结构化事件输出到脚本。资料未提供收费、价格、平台支持范围或效果保证等信息。