acpx
Provides a structured command-line interaction protocol for AI agents, replacing terminal emulation and character scraping.
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: acpx. It is used for: Provides a structured command-line interaction protocol for AI agents, replacing terminal emulation and character scraping. Full Skill content: https://321skill.com/skills/acpx/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
acpx is a headless command-line client for AI agents and orchestrators, implementing the Agent Client Protocol (ACP). It addresses the challenge of agents needing to emulate and scrape characters to interact with coding agents in traditional terminal (PTY) sessions, instead offering a structured communication protocol.
With acpx, developers or agents can use a unified command interface to communicate with ACP-compatible proxies such as Pi, OpenClaw ACP, Codex, and Claude. It supports features like persistent sessions, named sessions, prompt queues, and cooperative cancellation, making multi-turn conversations and collaboration between agents more stable and efficient.
This tool is ideal for agent developers, engineers seeking deep integration of AI assistants into development workflows, and architects building multi-agent collaboration systems. It elevates agent interactions from unstructured text streams to structured message exchanges.
Usage recommendation: As the project is in the alpha stage, its API and CLI interfaces may change. It is advisable to try it first in non-critical or experimental projects. Meanwhile, make full use of its session management, queue, and comparison features to optimize agent collaboration workflows.
Key Features
The core distinction is that it is not an AI tool that directly performs tasks, but rather a 'bridge' or 'client' that enables different AI coding agents (e.g., Pi, Codex) to conduct structured command-line communication with users or other agents via a standardized protocol (ACP). This fundamentally avoids the unreliability and complexity inherent in traditional terminal emulation (PTY scraping).
Limitations
Not suitable for scenarios requiring direct interaction with graphical interfaces or reliance on traditional command-line tools that do not use the ACP protocol.
FAQ
What is the difference between acpx and directly using the APIs of Codex or Claude?
acpx provides persistent command-line sessions and queue management based on the ACP protocol, supporting multi-agent parallel workflows and structured output, rather than just single API calls.
What can acpx be used for?
Primarily used to enable AI agents (e.g., your AI assistant) to collaborate in a structured, multi-turn manner via the command line with another ACP-compatible coding agent (e.g., Pi), for tasks such as bug fixing, writing code, and running tests.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/acpx/raw/index.md to read the original Skill definition (Markdown format) for acpx, and install it according to the instructions.
Raw Markdown URL for AI: /skills/acpx/raw/index.md