acpx
为AI智能体提供结构化命令行交互协议，替代终端模拟与字符抓取。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：acpx。 它的用途是：为AI智能体提供结构化命令行交互协议，替代终端模拟与字符抓取。 完整的 Skill 内容见：https://321skill.com/skills/acpx/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用 acpx 启动一个与 Codex 的会话，并让它检查当前项目中的测试失败原因。”，它会通过 acpx 向 Codex 智能体发送结构化的请求，并返回清晰的思考过程、工具调用和代码差异，而不是杂乱的终端输出。你还可以说：“比较一下 Pi 和 OpenClaw 对同一个重构任务的处理。”，acpx 会并行运行任务并对比两者的用时、Token 消耗和输出结果。
介绍
acpx 是一个面向 AI 智能体和编排器的无头命令行客户端，实现了 Agent Client Protocol (ACP)。它解决了智能体在传统终端（PTY）会话中需要通过模拟和抓取字符来与编码智能体交互的难题，转而提供一种结构化的通信协议。
通过 acpx，开发者或智能体可以使用统一的命令界面与 Pi、OpenClaw ACP、Codex、Claude 等兼容 ACP 协议的代理进行通信。它支持持久化会话、命名会话、提示词队列、协作式取消等功能，使智能体间的多轮对话和协作更加稳定和高效。
这个工具非常适合智能体开发者、希望将 AI 助手深度集成到开发工作流中的工程师，以及构建多智能体协作系统的架构师。它让智能体之间的交互从非结构化的文本流升级为结构化的消息交换。
使用建议：由于项目处于 alpha 阶段，API 和 CLI 接口可能发生变动，建议在非核心或实验性项目中先行试用。同时，可以充分利用其会话管理、队列和对比功能来优化智能体的协作流程。
核心特点
核心区别在于，它并非一个直接执行任务的 AI 工具，而是一个让不同 AI 编码智能体（如 Pi, Codex）能通过标准化协议（ACP）与用户或其他智能体进行结构化命令行通信的“桥梁”或“客户端”，从根本上避免了传统终端模拟（PTY scraping）的不可靠性和复杂性。
注意事项
不适合需要直接与图形界面交互或依赖非 ACP 协议的传统命令行工具的场景。
常见问题
acpx 和直接使用 Codex 或 Claude 的 API 有什么区别？
acpx 提供了基于 ACP 协议的、持久化的命令行会话和队列管理，支持多智能体并行工作流和结构化输出，而不仅仅是单次 API 调用。
acpx 能用来做什么？
主要用于让 AI 智能体（如你的 AI 助手）通过命令行与另一个 ACP 兼容的编码智能体（如 Pi）进行结构化、多轮次的协作，例如修复 Bug、编写代码、运行测试等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/acpx/raw/index.md 读取 acpx 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/acpx/raw/index.md（查看排版版本）