Référence : la commande ori

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

Synopsis

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.
`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

./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

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.

 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


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