Install

One line. Running in minutes.

The installer walks through Postgres setup, AI CLI installation, admin credentials, listen address, migrations, and service registration.

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

Alternative

Just the binary, no wizard.

For when you want the static binary on PATH without Postgres setup or service registration — scripted environments, ephemeral runners, or your own deployment system. Requires Node 18+.

Install globally — adds opendray to PATH

npm install -g opendray

Or run on demand without installing

npx opendray

The package pulls the matching opendray-{linux,darwin}-{x64,arm64} platform binary via optionalDependencies — the esbuild / Biome pattern, no postinstall, no network call at install time.

Requirements

Linux, macOS, or Windows WSL2 with Postgres 15+ and pgvector. The wizard helps bootstrap the common path.

Connect your CLIs

Claude Code, Codex, Gemini, and shell sessions can run behind the same gateway.

Configure channels

Start with Telegram for fast mobile replies, then add Slack, Discord, Feishu, DingTalk, WeCom, or Bridge.

Start session

Launch an agent from the web admin, CLI, API, or configured surface.

Disconnect

Close your laptop or leave the terminal. The server-side session keeps running.

Reconnect

Open the web UI or reply from your phone when the agent needs input.

Troubleshooting

The canonical install and troubleshooting docs are maintained in GitHub so operators have one source of truth.

Installer docs Getting started