opendray

opendray

Run Claude Code, Codex, Antigravity, Grok Build & OpenCode on your own server, and drive them from web, mobile, or chat.

opendray.dev

Latest release License Apache 2.0 CI Discussions
Go React Flutter Postgres

🌐 English · 简体中文 · فارسی · Español · Português · 日本語 · 한국어 · Français · Deutsch · Русский

--- Running an AI coding agent over SSH means it **dies the moment your laptop sleeps**. opendray runs it on a host that stays awake (a Mac mini, a NAS, a VPS) and lets you reattach from a browser, a phone, or a chat message. The session keeps executing whether or not anyone is connected. One Go binary. Your infrastructure. No cloud account, no telemetry, no subscription. ## Why opendray - **Sessions that never drop.** The agent runs on your host and survives client disconnect, laptop sleep, and host reboot. Reattach hours later; the transcript is exactly where you left it. - **Drive from anywhere.** A React web admin, a Flutter mobile app, and six chat channels (Telegram, Slack, Discord, Feishu, DingTalk, WeCom), every one bidirectional. Get pinged when a session goes idle; reply to feed the next prompt back in. - **Five agents, one gateway.** Claude Code, Codex, Antigravity, Grok Build, OpenCode, plus any shell. Adding a CLI is a JSON descriptor drop-in. - **Multi-account fleet.** Drop several logged-in accounts on the host; opendray pools them, balances new sessions, and switches a live session between accounts **without losing the conversation**. - **Local-first memory.** Cross-session recall across user / project / session scopes, embeddings from ONNX, Ollama, or LM Studio. No vector data leaves your network. - **Built to build on.** REST + WebSocket API with scoped keys, per-call audit log, and reverse-proxy mounts. Use opendray as your own product's agent runtime. - **Self-hosted & licence-clear.** Apache 2.0, one static binary, cosign-signed releases. ## Quick start **Linux / macOS / WSL2.** The installer walks through Postgres, CLI install, admin credentials, and service registration (~5–10 min): ```sh curl -fsSL https://raw.githubusercontent.com/Opendray/opendray/main/scripts/install.sh | bash ``` **Windows** sets up WSL2, then runs the same installer inside it: ```powershell irm https://raw.githubusercontent.com/Opendray/opendray/main/scripts/install-windows.ps1 | iex ``` **Just the binary** (bring your own Postgres + supervisor): ```sh npx opendray # or: npm install -g opendray ``` Then open the web admin at **`http://:8770/admin/`**. 📖 Prefer to do it by hand? The [15-minute getting-started guide](docs/getting-started.md) mirrors each step. Binary-only setup lives in [docs/install-binary.md](docs/install-binary.md); production deploy (systemd / launchd) in [docs/getting-started.md](docs/getting-started.md). ## Features | | | | --- | --- | | **Sessions** | Attach to a running Claude Code, Codex, Antigravity, Grok Build, OpenCode, or shell session from web, mobile, or chat. Survive client disconnect and host reboot. Image attachments, TUI theme-following, mouse-wheel scroll in full-screen TUIs. | | **Round Table** *(experimental)* | Seat several providers plus yourself in one shared thread. `@mention` who replies (or `@all`); each answers in character after reading the whole conversation. Summarize it, or convert it into a role-assigned, multi-session execution plan. | | **Providers** | 5 first-class AI coding CLIs plus arbitrary shell. New CLI = a JSON descriptor under `internal/catalog/builtin/`. Per-provider MCP-server injection. One-click version checks + updates. | | **Memory** | Three-scope retrieval (user, project, session). Local-first embeddings via ONNX, Ollama, or LM Studio. Cross-layer conflict detection. Knowledge pages injected at spawn. | | **Database** | Inspect and query project databases from the session inspector: PostgreSQL, MySQL, MariaDB, SQLite. Per-project isolation. Web and mobile. | | **Channels** | Telegram, Slack, Discord, Feishu, DingTalk, WeCom, plus a Bridge adapter for custom transports. Bidirectional: sessions notify, replies feed back. | | **Integrations** | REST + WebSocket API with scoped keys, per-call audit log, reverse-proxy mounts. HashiCorp Vault MCP. See [integration guide](docs/integration-guide.md). | | **Session env (host tools)** | A generic `[session.env]` / `[session.env_files]` config injects env vars — including host-CLI credentials — into every session, so any provider's agent inherits them with no per-provider setup and nothing tool-specific in the core. Example: point `TYPESAFE_API_KEY` at a key file and every agent can call [Jev](https://docs.typesafe.ai) (TypeSafe "System One") for calibrated, hallucination-free decisions (classify, verify, route, screen) returning JSON probabilities in ~half a second. | | **Ops & security** | Single Go binary. One-line installer (Linux, macOS, WSL2). Self-managing (`opendray update / start / stop`). Encrypted Postgres backups. Cosign-signed releases + SPDX SBOM. Apache 2.0, no telemetry. | ## How it compares | | opendray | Claude Desktop | Cursor | CLI over SSH | ChatGPT Desktop | | --- | --- | --- | --- | --- | --- | | Session survives client disconnect | ✅ | ❌ | ❌ | ⚠️ tmux/screen | ❌ | | Multi-account pool with live switch | ✅ | ❌ | ❌ | ❌ | ❌ | | Cross-session memory layer | ✅ | ❌ | Partial | ❌ | Partial | | Host filesystem + tool use | ✅ | Limited | ✅ | ✅ | Limited | | Mobile client with feature parity | ✅ | ❌ | ❌ | ⚠️ SSH client | Partial | | Chat channel adaptors | ✅ (6) | ❌ | ❌ | ❌ | ❌ | | Self-hosted | ✅ | ❌ | ❌ | ✅ | ❌ | | Licence | Apache 2.0 | Proprietary | Proprietary | (varies) | Proprietary | Against self-hosted chat frontends (Open WebUI, LibreChat, Dify): opendray runs the **actual agent CLI** with tool use and file writes on the host, in a reattachable PTY, not just a chat box in front of an API. ## Who it's for - **Homelab solo dev.** You have a box running 24/7 and you're tired of Claude Code dying when your laptop sleeps. Keep it running; reattach from your phone. - **Small-team lead.** Pool 3–5 accounts, watch per-account usage, hand teammates scoped keys and a mobile app with no App Store submission. - **Integrator.** You need to spawn agent sessions with tool use and don't want to reimplement session lifecycle, PTY handling, memory, or channel routing. Treat opendray as your agent runtime. ## How it works A single Go binary on your host serves the web admin (`/admin/`) and a REST + WebSocket API (`/api/v1/*`). Clients drive sessions over HTTP/WS; the session manager spawns each AI CLI in its own PTY; the memory layer keeps shared state in Postgres with vector embeddings from your own provider. Everything runs on your network, with no inference outside your control. > **Note:** opendray shares process state (`~/.claude`, ssh-agent, project files) with the CLIs it spawns, which is incompatible with production container isolation, so Docker is not a supported deploy path for v2.x. Run it on a host (bare metal, VM, or LXC). ## Production deploy The one-line installer sets up a service for you. To wire it up yourself, each path gives you auto-restart on crash, persistent state, and secrets kept out of config. **systemd (Linux, recommended).** Ships a hardened unit at [`deploy/systemd/opendray.service`](deploy/systemd/opendray.service) (`ProtectSystem=strict`, `NoNewPrivileges`, `migrate`-then-`serve` boot): ```sh sudo install -m 0755 ./opendray /usr/local/bin/opendray sudo useradd -r -s /usr/sbin/nologin -d /var/lib/opendray opendray sudo install -D -m 0640 config.example.toml /etc/opendray/config.toml # set [database].url sudo cp deploy/systemd/opendray.service /etc/systemd/system/ sudo systemctl enable --now opendray ``` **macOS (Mac mini / Studio as home server)** uses a LaunchDaemon, and any other supervisor (OpenRC, FreeBSD `rc.d`) works with the plain binary. Full walkthroughs (secrets file, launchd plist, updates) live in [docs/install-binary.md](docs/install-binary.md). ## Docs & community - 🚀 [Getting started](docs/getting-started.md) · [Quickstart (dev)](docs/quickstart.md) · [Binary install](docs/install-binary.md) - 🔌 [Integration guide](docs/integration-guide.md) - 💬 [Discussions](https://github.com/Opendray/opendray/discussions) · [Releases](https://github.com/Opendray/opendray/releases) ## License [Apache 2.0](LICENSE). No telemetry, no cloud account, no subscription.