How to use another ACP agent

This guide shows how to connect Ori to any agent that speaks ACP on stdio. It assumes you know how to start Ori (see run with Claude Code).

Steps

Identify the command that starts your agent in ACP mode. The agent must read JSON-RPC from stdin and write it to stdout.

Pass that command to Ori with --agent-cmd:

./bin/ori --agent-cmd "gemini --experimental-acp"

Open the panel: the hello header shows the session id the agent returned.

Variants

The bundled demo agent is itself just another ACP agent: ./bin/ori --agent-cmd "bin/ori-mock-agent" (that is what make run-mock does).
The command is split on whitespace: the first word is the executable, the rest are its arguments. Arguments containing spaces are not supported — wrap such a command in a small shell script and pass the script instead.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# How to use another ACP agent

This guide shows how to connect Ori to any agent that speaks ACP on stdio. It assumes you know how to start Ori (see [run with Claude Code](run-with-claude-code.md)).

## Steps

1. Identify the command that starts your agent in ACP mode. The agent must read JSON-RPC from stdin and write it to stdout.
2. Pass that command to Ori with `--agent-cmd`:

   ```bash
   ./bin/ori --agent-cmd "gemini --experimental-acp"
   ```

3. Open the panel: the `hello` header shows the session id the agent returned.

## Variants

- The bundled demo agent is itself just another ACP agent: `./bin/ori --agent-cmd "bin/ori-mock-agent"` (that is what `make run-mock` does).
- The command is split on whitespace: the first word is the executable, the rest are its arguments. Arguments containing spaces are not supported — wrap such a command in a small shell script and pass the script instead.

## See also

- Flags reference: [the ori command](../reference/cli.md)
- What Ori expects from the agent: [explanation: architecture](../explanation/architecture.md)