use-acpx

acpx 是面向 Agent Client Protocol（ACP）的无头、可脚本化 CLI 客户端，用于命令行下的智能体间通信，避免 PTY 抓取。安装：npm i -g acpx，需复用会话时优先全局安装而非 npx。命令模型为 acpx [global_options] [<agent>] [verb] [prompt_options] [prompt_text...]，动词包括 prompt（默认）、exec、cancel、set-mode、set、status、sessions、config；省略提示文本且管道输入时从 stdin 读取。内置注册表将友好名映射到命令，如 pi、openclaw、codex、gemini、cursor、copilot、droid、kimi、opencode、kiro、kilocode、qwen，默认智能体为 codex，未知位置参数按原始命令处理，也可用 --agent 指定原始适配器命令，二者不可同时使用。主要能力：按 repo/cwd 持久多轮会话、一次性 exec、命名并行会话（-s/--session，仅 prompt）、队列感知提交与 --no-wait、协作式 cancel、会话控制 set-mode 与 set、子进程失效后重连恢复、stdin 或 --file 输入、全局与项目配置合并及 config show|init、会话元数据与历史查看、status 本地进程检查、结构化流式输出（text/json/quiet）、认证握手与环境凭据。资料强调所有 acpx 命令必须后台执行（run_in_background: true），前台运行会阻塞会话；禁止使用 Claude 相关 ACP 智能体，以免递归循环。会话按 agentCommand、绝对 cwd 与可选名称限定，记录存于 ~/.acpx/sessions/*.json；prompt 模式会向上查找 git 根自动恢复，无会话时退出码 4。队列由首个进程作为 owner，空闲 TTL 默认 300 秒。权限模式三选一：--approve-all、--approve-reads（默认）、--deny-all。其他选项含 --cwd、--timeout、--ttl、--verbose 等。完整语法、退出码与 IPC 细节见 references/cli.md，本资料未提供更多信息。