# Référence : la commande ori

> Description neutre et exhaustive du binaire serveur `ori` et de ses options.

## Synopsis

```bash
ori [--addr ADDR] [--cwd DIR] [--agent-cmd COMMANDE]
```

Au démarrage, `ori` lance la commande de l'agent, effectue la poignée de main ACP (`initialize`, puis `session/new`), puis sert l'application web et son endpoint WebSocket. Si l'agent ne démarre pas ou si la poignée de main échoue, `ori` se termine avec un statut non nul et une erreur sur stderr.

## Options

| Option | Type | Défaut | Description |
| --- | --- | --- | --- |
| `--addr` | chaîne | `:8888` | Adresse TCP d'écoute du serveur HTTP. Un hôte vide écoute sur toutes les interfaces. |
| `--cwd` | chaîne | répertoire courant | Répertoire de travail transmis à la session de l'agent. Doit exister et être un répertoire ; résolu en chemin absolu. |
| `--agent-cmd` | chaîne | `npx -y @agentclientprotocol/claude-agent-acp` | Commande lançant l'agent ACP, découpée sur les espaces (premier champ : exécutable ; le reste : arguments). |

## Endpoints HTTP

| Route | Description |
| --- | --- |
| `GET /healthz` | Renvoie `{"status":"ok"}` avec le statut 200. |
| `GET /ws` | Endpoint WebSocket du panel ; voir la [référence du protocole WebSocket](websocket-protocol.md). |
| `GET /*` | La SPA embarquée ; les chemins inconnus retombent sur `index.html`. Renvoie 503 si le binaire a été compilé sans build de l'interface. |

## Exemple

```bash
./bin/ori --addr :9000 --cwd /travail/mon-projet --agent-cmd "bin/ori-mock-agent"
```

## Erreurs

| Erreur | Cause |
| --- | --- |
| `--agent-cmd must not be empty` | L'option ne contient que des blancs. |
| `--cwd: … no such file or directory` | Le répertoire de travail n'existe pas. |
| `--cwd: … is not a directory` | Le chemin existe mais est un fichier ordinaire. |
| `start agent "…": …` | L'exécutable de l'agent n'a pas pu être lancé. |
| `initialize: …` / `new session: …` | La poignée de main ACP avec l'agent a échoué. |

## Binaire compagnon : ori-mock-agent

```bash
ori-mock-agent [--delay DURÉE]
```

| Option | Type | Défaut | Description |
| --- | --- | --- | --- |
| `--delay` | durée | `300ms` | Pause entre les updates streamées. `0s` désactive la cadence. |

`ori-mock-agent` parle ACP sur stdio et joue un scénario déterministe par prompt : une réflexion, un plan à deux entrées, un tool call de lecture, une demande de permission, et — si elle est accordée — un tool call d'édition avec un diff et un message final.