# Ori
> The origin from which many voices are called, and through which they are known

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.

![ori-desktop](/bots-garden/ori/raw/main/assets/ori-desktop.png)

## Quick Start

```
sbx run -d claude . \
  --template k33g/ori:0.0.3 \
  --kit docker.io/k33g/ori-kit:latest \
  --name hello-world \
  -p 5555:8888/tcp
```
Then open **http://localhost:5555** — the panel connects to a Claude Code session already running in the sandbox, no login needed.

Or you can use **ori-desktop**

```bash
cd ori-desktop
wails build
xattr -cr build/bin/ori-desktop.app
```
Then **double-click** on the application

## How to start

From the directory where the kit lives, pointing at the project you want the agent to work on:

```bash
sbx run -d claude . \
  --template k33g/ori:0.0.2 \
  --kit ./kits/ori \
  --name hello-ori \
  -p 3000:8888/tcp

sbx run -d claude . \
  --template k33g/ori:0.0.2 \
  --kit https://rickub.com/bots-garden/kits/ori  \
  --name hello-ori \
  -p 3000:8888/tcp
```

Then open **http://localhost:8888** — the panel connects to a Claude Code session already running in the sandbox, no login needed.


## Documentation

Full documentation, in English and French, lives in [`docs/`](docs/README.md) — tutorials, how-to guides, reference (CLI, WebSocket protocol) and architecture notes.