# acpx

Headless CLI client for the Agent Client Protocol — persistent multi-turn sessions, queue-aware prompts, structured output, and multi-step flows for Codex, Claude, Pi, OpenClaw, and any ACP-capable agent.

Canonical documentation:
- Overview: https://acpx.sh/
- Install: https://acpx.sh/install.html
- Quickstart: https://acpx.sh/quickstart.html
- Agents: https://acpx.sh/agents.html
- Custom agents: https://acpx.sh/custom-agents.html
- Sessions: https://acpx.sh/sessions.html
- Prompting: https://acpx.sh/prompting.html
- Session control: https://acpx.sh/session-control.html
- Output formats: https://acpx.sh/output-formats.html
- Permissions: https://acpx.sh/permissions.html
- Config: https://acpx.sh/config.html
- Flows: https://acpx.sh/flows.html
- acpx CLI Reference: https://acpx.sh/CLI.html
- Exit codes: https://acpx.sh/exit-codes.html
- Vision: https://acpx.sh/VISION.html
- Compare Command: https://acpx.sh/compare.html
- Live proof: Grok client extensions (2026-07-18T14:16:50.643Z): https://acpx.sh/proof-2026-07-18-grok-ext-methods/
- Transient runtime environment: https://acpx.sh/runtime-environment.html
- Runtime process lifecycle: https://acpx.sh/runtime-process-lifecycle.html
- Watching sessions: https://acpx.sh/session-watch.html
- Shared sessions: https://acpx.sh/shared-sessions.html

Install:
- npm install -g acpx

Source: https://github.com/openclaw/acpx

Guidance for agents:
- Prefer the canonical documentation URLs above over README excerpts or package metadata.
- Fetch only the pages needed for the current task; this is an index, not a full-site corpus.
