acp-cli 0.1.0

Headless CLI client for the Agent Client Protocol (ACP)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

# acp-cli

Headless CLI client for the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/). Rust port of [ACPX](https://github.com/openclaw/acpx).

Talk to coding agents (Claude, Codex, Gemini, etc.) over a structured protocol instead of terminal scraping.

## Install

```bash
cargo install acp-cli
```

## Usage

```bash
# Simple prompt (uses claude by default)
acp-cli claude "fix the auth bug"

# One-shot mode (no session persistence)
acp-cli claude exec "what does this function do?"

# JSON output for automation
acp-cli claude "list all TODOs" --format json

# Quiet mode (final text only)
acp-cli claude "what is 2+2?" --format quiet --approve-all

# Use a different agent
acp-cli codex "refactor this module"
acp-cli gemini "explain this error"

# Named sessions for parallel work
acp-cli claude -s backend "fix the API"
acp-cli claude -s frontend "update the UI"

# Custom timeout
acp-cli claude "large refactor task" --timeout 120
```

## Supported Agents

| Agent | Command |
|-------|---------|
| claude | `npx @zed-industries/claude-agent-acp` |
| codex | `npx @zed-industries/codex-acp` |
| gemini | `gemini --acp` |
| copilot | `copilot --acp --stdio` |
| cursor | `cursor-agent acp` |
| goose | `goose acp` |
| kiro | `kiro-cli acp` |
| pi | `npx pi-acp` |
| openclaw | `openclaw acp` |
| opencode | `npx opencode-ai acp` |
| kimi | `kimi acp` |
| qwen | `qwen --acp` |
| droid | `droid exec --output-format acp` |

Unknown agent names are treated as raw commands.

## Permission Modes

| Flag | Behavior |
|------|----------|
| `--approve-all` | Auto-approve all tool calls |
| `--approve-reads` | Approve read-only tools, deny writes (default) |
| `--deny-all` | Deny all tool calls |

## Output Formats

- **text** (default) — streaming text with tool status
- **json** — NDJSON, one event per line
- **quiet** — final text only

## Config

Create `~/.acp-cli/config.json`:

```json
{
  "default_agent": "claude",
  "default_permissions": "approve_reads",
  "timeout": 60,
  "agents": {
    "my-agent": {
      "command": "./custom-agent",
      "args": ["--flag"]
    }
  }
}
```

## Session Management

```bash
acp-cli claude sessions new              # create new session
acp-cli claude sessions new --name api   # named session
acp-cli claude sessions list             # list sessions
```

Sessions auto-resume by matching `(agent, git_root, name)`.

## License

MIT