forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # How to use another ACP agent |
| 2 | ||
| 3 | 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)). | |
| 4 | ||
| 5 | ## Steps | |
| 6 | ||
| 7 | 1. Identify the command that starts your agent in ACP mode. The agent must read JSON-RPC from stdin and write it to stdout. | |
| 8 | 2. Pass that command to Ori with `--agent-cmd`: | |
| 9 | ||
| 10 | ```bash | |
| 11 | ./bin/ori --agent-cmd "gemini --experimental-acp" | |
| 12 | ``` | |
| 13 | ||
| 14 | 3. Open the panel: the `hello` header shows the session id the agent returned. | |
| 15 | ||
| 16 | ## Variants | |
| 17 | ||
| 18 | - 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). | |
| 19 | - 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. | |
| 20 | ||
| 21 | ## See also | |
| 22 | ||
| 23 | - Flags reference: [the ori command](../reference/cli.md) | |
| 24 | - What Ori expects from the agent: [explanation: architecture](../explanation/architecture.md) |