Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@ node_modules/
dist/
dist-test/
*.tgz
.worktrees/
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Your agents love acpx! 🤖❤️ They hate having to scrape characters from a P

`acpx` is a headless CLI client for the [Agent Client Protocol (ACP)](https://agentclientprotocol.com), so AI agents and orchestrators can talk to coding agents over a structured protocol instead of PTY scraping.

One command surface for Codex, Claude, Gemini, OpenClaw ACP, OpenCode, Pi, or custom ACP servers. Built for agent-to-agent communication over the command line.
One command surface for Codex, Claude, Gemini, OpenClaw ACP, OpenCode, Pi, Kilocode, or custom ACP servers. Built for agent-to-agent communication over the command line.

- **Persistent sessions**: multi-turn conversations that survive across invocations, scoped per repo
- **Named sessions**: run parallel workstreams in the same repo (`-s backend`, `-s frontend`)
Expand Down Expand Up @@ -128,6 +128,7 @@ The only prerequisite is the underlying coding agent you want to use:
- `acpx opencode` -> OpenCode: https://opencode.ai
- `acpx kiro` -> Kiro CLI: https://kiro.dev
- `acpx pi` -> Pi Coding Agent: https://github.com/mariozechner/pi
- `acpx kilocode` -> Kilocode: https://kilocode.ai

## Usage examples

Expand Down Expand Up @@ -282,6 +283,7 @@ Built-ins:
| `openclaw` | native | [OpenClaw ACP bridge](https://github.com/openclaw/openclaw) |
| `opencode` | native | [OpenCode](https://opencode.ai) |
| `pi` | [pi-acp](https://github.com/svkozak/pi-acp) | [Pi Coding Agent](https://github.com/mariozechner/pi) |
| `kilocode` | native | [Kilocode](https://kilocode.ai) |

Use `--agent` as an escape hatch for custom ACP servers:

Expand Down
1 change: 1 addition & 0 deletions src/agent-registry.ts
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ export const AGENT_REGISTRY: Record<string, string> = {
opencode: "npx -y opencode-ai acp",
kiro: "kiro-cli acp",
pi: "npx pi-acp",
kilocode: "npx -y @kilocode/cli acp",
};

export const DEFAULT_AGENT_NAME = "codex";
Expand Down
17 changes: 14 additions & 3 deletions test/agent-registry.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ test("resolveAgentCommand maps known agents to commands", () => {
["opencode", "npx -y opencode-ai acp"],
["kiro", "kiro-cli acp"],
["pi", "npx pi-acp"],
["kilocode", "npx -y @kilocode/cli acp"],
]);

for (const [name, command] of expected) {
Expand All @@ -27,12 +28,22 @@ test("resolveAgentCommand returns raw value for unknown agents", () => {
assert.equal(resolveAgentCommand("custom-acp-server"), "custom-acp-server");
});

test("listBuiltInAgents returns exactly all 7 registered agent names", () => {
test("listBuiltInAgents returns exactly all 9 registered agent names", () => {
const agents = listBuiltInAgents();
assert.equal(agents.length, 8);
assert.equal(agents.length, 9);
assert.deepEqual(
new Set(agents),
new Set(["copilot", "codex", "claude", "gemini", "openclaw", "opencode", "kiro", "pi"]),
new Set([
"copilot",
"codex",
"claude",
"gemini",
"openclaw",
"opencode",
"kiro",
"pi",
"kilocode",
]),
);
});

Expand Down
Loading