| name | acp-setup |
| description | Install and manage acpx — the ACP agent client for delegating tasks to coding agents. Use before first agent_session call or when checking available coding agents. |
| metadata | {"author":"Fae","version":"1.0.0"} |
| tags | ["acp","agents","setup","coding","delegation"] |
ACP Setup — Agent Client Protocol
Install and manage acpx, the headless CLI client for the Agent Client Protocol (ACP).
acpx lets Fae delegate tasks to external coding agents like Claude Code, Codex,
Gemini CLI, and Copilot.
When to Use
- Before the first
agent_session or agent_delegate tool call
- When the user asks to delegate coding work to an external agent
- When checking which coding agents are available
Commands
install — Install acpx
Checks for existing installation, installs if missing. Tries multiple methods:
- Check if already installed (npx, bun, or standalone binary)
- Install via
bun install -g acpx (preferred — fast, no Node.js needed)
- Fall back to
npm install -g acpx (requires Node.js)
{}
{"method": "bun"}
status — Check installation
Reports: installed (yes/no), version, path, available agents.
{}
Notes
- acpx is ~1MB via npm, or ~58MB as standalone bun binary
- First install may take 10-30 seconds
- acpx stores sessions at
~/.acpx/
- Available agents depend on what's installed on the system (Claude Code, Codex, etc.)
