forked from bots-garden/ori
| 🎉 Begin a project. | 1 | # Ori |
| 2 | > The origin from which many voices are called, and through which they are known | |
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 3 | |
| 4 | Ori is a web client for [ACP (Agent Client Protocol)](https://agentclientprotocol.com) code agents: a Go backend serves a React single-page application and connects, over ACP, to an agent such as Claude Code. The browser gets a Zed-style agent panel — streamed answers, thoughts, tool calls, plans and permission prompts — plus a workspace panel: resizable file tree, syntax-highlighted previews (with rendered Markdown and AsciiDoc), a Monaco editor and an interactive terminal. Light and dark themes, switchable from the header. | |
| 5 | ||
| 🛟 Updated. | 6 |  |
| 🛟 Updated. | 7 | |
| 8 | ## Quick Start | |
| 9 | ||
| 10 | ``` | |
| 11 | sbx run -d claude . \ | |
| 12 | --template k33g/ori:0.0.3 \ | |
| 13 | --kit docker.io/k33g/ori-kit:latest \ | |
| 14 | --name hello-world \ | |
| 15 | -p 5555:8888/tcp | |
| 16 | ``` | |
| 17 | Then open **http://localhost:5555** — the panel connects to a Claude Code session already running in the sandbox, no login needed. | |
| 18 | ||
| 19 | Or you can use **ori-desktop** | |
| 20 | ||
| 21 | ```bash | |
| 22 | cd ori-desktop | |
| 23 | wails build | |
| 24 | xattr -cr build/bin/ori-desktop.app | |
| 25 | ``` | |
| 26 | Then **double-click** on the application | |
| 27 | ||
| 28 | ## How to start | |
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 29 | |
| 🛟 Updated. | 30 | From the directory where the kit lives, pointing at the project you want the agent to work on: |
| 31 | ||
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 32 | ```bash |
| ✨ Switch the ACP adapter to @agentclientprotocol/claude-agent-acp (template 0.0.2) | 33 | sbx run -d claude . \ |
| 34 | --template k33g/ori:0.0.2 \ | |
| 🛟 Updated. | 35 | --kit ./kits/ori \ |
| ✨ Switch the ACP adapter to @agentclientprotocol/claude-agent-acp (template 0.0.2) | 36 | --name hello-ori \ |
| 37 | -p 3000:8888/tcp | |
| 38 | ||
| 39 | sbx run -d claude . \ | |
| 40 | --template k33g/ori:0.0.2 \ | |
| 41 | --kit https://rickub.com/bots-garden/kits/ori \ | |
| 42 | --name hello-ori \ | |
| 43 | -p 3000:8888/tcp | |
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 44 | ``` |
| 45 | ||
| 🛟 Updated. | 46 | Then open **http://localhost:8888** — the panel connects to a Claude Code session already running in the sandbox, no login needed. |
| 47 | ||
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 48 | |
| 49 | ## Documentation | |
| 50 | ||
| 51 | Full documentation, in English and French, lives in [`docs/`](docs/README.md) — tutorials, how-to guides, reference (CLI, WebSocket protocol) and architecture notes. |