- CollectionAgent Runtime & Infrastructure
- Classificationagent-native
- MCPNot applicable
- Agent SkillAvailable
- InterfacesURL onboarding · Agent Skill · CLI · ACP · http
What it does
acpx is a headless CLI client for the Agent Client Protocol (ACP). It enables AI agents and orchestrators to delegate work to coding agents (Pi, OpenClaw, Codex, Claude, etc.) over a structured protocol instead of scraping PTY sessions. One command surface for all ACP-compatible agents.
Core value: typed ACP messages (thinking, tool calls, diffs) instead of ANSI scraping. Agents get structured, parseable output and can manage persistent sessions, queue prompts, and cancel in-flight work cooperatively.
Agent-facing interfaces
- Interaction pattern: Coding-time Skill + CLI
- Catalog protocols: URL onboarding, Agent Skill, CLI, ACP, http
- MCP: ⚠️ Not applicable — acpx is a CLI client that implements the ACP protocol. Agents invoke it as a subprocess; it does not expose an MCP server.
- Agent Skill: ✅ Available
- Onboarding type:
url
How agents onboard
Interaction pattern: Coding-time Skill + CLI
# Install acpx globally (recommended for session reuse)
npm install -g acpx@latest
# Install the acpx skill for full command reference
npx acpx@latest --skill install acpx
# Read the skill reference for all commands and workflows
# Read https://raw.githubusercontent.com/openclaw/acpx/main/skills/acpx/SKILL.md
# Delegate to a coding agent via ACP
npx acpx@latest codex "fix the failing tests"
npx acpx@latest claude "refactor the auth module"
npx acpx@latest exec "one-shot: summarize this repo"
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| CLI | acpx — primary interface; agents invoke via subprocess |
| Config | JSON config files: global + project merge; acpx config show|init |
| Skill | npx acpx@latest --skill install acpx — installs SKILL.md for agent reference |
| Protocol | Implements Agent Client Protocol (ACP) |