# 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)