forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # Référence : la commande ori |
| 2 | ||
| 3 | > Description neutre et exhaustive du binaire serveur `ori` et de ses options. | |
| 4 | ||
| 5 | ## Synopsis | |
| 6 | ||
| 7 | ```bash | |
| 8 | ori [--addr ADDR] [--cwd DIR] [--agent-cmd COMMANDE] | |
| 9 | ``` | |
| 10 | ||
| 11 | 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. | |
| 12 | ||
| 13 | ## Options | |
| 14 | ||
| 15 | | Option | Type | Défaut | Description | | |
| 16 | | --- | --- | --- | --- | | |
| 17 | | `--addr` | chaîne | `:8888` | Adresse TCP d'écoute du serveur HTTP. Un hôte vide écoute sur toutes les interfaces. | | |
| 18 | | `--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. | | |
| 19 | | `--agent-cmd` | chaîne | `npx -y @zed-industries/claude-code-acp` | Commande lançant l'agent ACP, découpée sur les espaces (premier champ : exécutable ; le reste : arguments). | | |
| 20 | ||
| 21 | ## Endpoints HTTP | |
| 22 | ||
| 23 | | Route | Description | | |
| 24 | | --- | --- | | |
| 25 | | `GET /healthz` | Renvoie `{"status":"ok"}` avec le statut 200. | | |
| 26 | | `GET /ws` | Endpoint WebSocket du panel ; voir la [référence du protocole WebSocket](websocket-protocol.md). | | |
| 27 | | `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. | | |
| 28 | ||
| 29 | ## Exemple | |
| 30 | ||
| 31 | ```bash | |
| 32 | ./bin/ori --addr :9000 --cwd /travail/mon-projet --agent-cmd "bin/ori-mock-agent" | |
| 33 | ``` | |
| 34 | ||
| 35 | ## Erreurs | |
| 36 | ||
| 37 | | Erreur | Cause | | |
| 38 | | --- | --- | | |
| 39 | | `--agent-cmd must not be empty` | L'option ne contient que des blancs. | | |
| 40 | | `--cwd: … no such file or directory` | Le répertoire de travail n'existe pas. | | |
| 41 | | `--cwd: … is not a directory` | Le chemin existe mais est un fichier ordinaire. | | |
| 42 | | `start agent "…": …` | L'exécutable de l'agent n'a pas pu être lancé. | | |
| 43 | | `initialize: …` / `new session: …` | La poignée de main ACP avec l'agent a échoué. | | |
| 44 | ||
| 45 | ## Binaire compagnon : ori-mock-agent | |
| 46 | ||
| 47 | ```bash | |
| 48 | ori-mock-agent [--delay DURÉE] | |
| 49 | ``` | |
| 50 | ||
| 51 | | Option | Type | Défaut | Description | | |
| 52 | | --- | --- | --- | --- | | |
| 53 | | `--delay` | durée | `300ms` | Pause entre les updates streamées. `0s` désactive la cadence. | | |
| 54 | ||
| 55 | `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. |