acpx CLI
acpx drives coding agents over ACP from the command line: repository sessions and one command shape for 30 agents
- 3,430 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Launches coding agents that change files and run commands in the repository
- Stores sessions on disk
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/acpxDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Launches coding agents that change files and run commands in the repository
- Stores sessions on disk
This is third-party code. Review the repository files before installing.
What it does
acpx is a headless command-line client for the Agent Client Protocol. It gives agents, orchestrators and developers one structured interface to persistent sessions, one-shot runs and permissions with machine-readable output, with no terminal text parsing. A session is scoped to the current repository and persists across runs. You create it first with `acpx codex sessions new`, then send a prompt: `acpx codex "summarize this repository"`. Thirty built-in profiles, among them Codex, Claude Code, Gemini CLI, Cursor, GitHub Copilot, Goose, Kiro and OpenClaw, launch with the same command shape. The repository ships a `skills/acpx` skill that teaches an agent to use the client.
Who it is for. Builders of orchestrators and automation around several coding agents who want one interface instead of different CLIs.
Good fit when
- One agent calls another, for example Claude Code asks Codex to review a solution.
- A script has to keep a long session with an agent and feed requests in turn.
- The same task runs on several agents and results are compared.
- Automation must not start a new conversation by accident: sessions are created explicitly.
- Different agent launch commands are normalized into one form.
Not a fit when
- You only need an interactive chat with one agent: its own CLI is enough.
- The agent does not support ACP or is not among the profiles and has no adapter.
- A stable interface is required: before 1.0 commands and runtime change.
Example request
Through acpx create a Codex session in this repository and ask it to find the slowest test and explain why.Limitations
The project is pre-1.0, so commands and runtime interfaces may change. Node.js 22.13 or newer is required. You install and authenticate the agent beforehand: acpx only launches it, and the CLI or adapter requirements are in each profile's guide. Capabilities depend on the agent, and some profiles such as Ante are experimental. Persistent sessions are stored on disk tied to the repository, so secrets typed into prompts also remain in those files.
How to disable. Remove the package with `npm uninstall -g acpx`. Saved sessions and settings remain on disk and are deleted separately.
FAQ
How do I install it?
Run `npm install -g acpx@latest`. Without a global install, `npx acpx@latest` works. Node.js 22.13 or newer is required.
How do I start?
Create a session in the repository: `acpx codex sessions new`. Then send a prompt: `acpx codex "find the slowest test and explain why"`.
Which agents are supported?
Thirty built-in profiles, including Pi, OpenClaw, Codex, Claude Code, Gemini CLI, Cursor, GitHub Copilot, Goose, Kiro and Kimi. The command shape is the same.
Is the session saved?
Yes. It is scoped to the current repository and lives across runs. Explicit creation keeps automation from starting an extra conversation.
Is there a skill for an agent?
Yes, `skills/acpx` in the repository teaches an agent to call the client and manage sessions.
Discussion
No questions or reviews yet.
Related
CLI toolsA Python coding agent over the ACP protocol: it reads and edits code, keeps every session in SQL and searches them.
A bridge between local CLI agents: Codex, Cursor or Claude Code delegate work to Antigravity, Grok, Kimi and seven more.
PromptOps keeps Claude Code, Codex and Gemini CLI side by side by project and gives a lead agent MCP to launch helpers
Axel runs named agents on Claude Code, Codex and more in the Rex terminal, and task threads outlive a closed laptop
A CLI that keeps coding agents' shared context in one place: instructions, skills, MCPs, subagents and durable memory across projects and machines
Agents Can Communicate (ACC)
Agents Can Communicate
ACC passes questions, reviews and handoffs between Claude Code, Codex and other client sessions on one machine
README in short
The README shows a sample Codex exchange and warns the client is pre-1.0. Install, quick start and a table of agent profiles follow.