Quick Start

Zero to a persistent session in ~5 minutes.

Install the gateway, start an agent, then reconnect from anywhere — your laptop, the web admin, or a Telegram reply.

curl -fsSL https://raw.githubusercontent.com/Opendray/opendray/main/scripts/install.sh | bash

Prefer npm? npm install -g opendray or npx opendray gives you just the static binary on PATH. More install options →

1 · Install

Run the one-liner above. The wizard sets up Postgres + pgvector, your AI CLIs, an admin login, and registers the service.

2 · Open the admin

Visit the listen address the installer prints and sign in. A single Go binary serves the web UI, API, and live session stream.

3 · Start a session

Spawn a Claude Code, Codex, Antigravity, Grok Build, OpenCode, or shell session. It runs server-side on a real PTY — not in a browser tab.

4 · Connect a channel

Add a Telegram bot under Channels and set your owner ID. Optionally add Slack, Discord, Feishu, DingTalk, WeCom, or Bridge.

5 · Disconnect

Close the laptop. The session keeps running on your server with scrollback intact.

6 · Reply from your phone

When the agent goes idle or asks a question, you get a Telegram message — reply to feed the next prompt straight back in.

Persistent by default

Sessions survive disconnects, client reboots, and device switches. Reconnect and continue where you left off.

Drive it from anywhere

Web admin, REST + WebSocket API, or a chat app — the same session, many surfaces.

Self-hosted

Runs on your own server, NAS, or VPS. No cloud account, no telemetry, no vendor lock-in.

Next steps

Full install options and troubleshooting live in the install guide and the documentation.