Relay — The control plane for your AI workforce
Run AI agents on your own computers, coordinate them as teams, and follow their work from your desktop or phone. Relay supports Codex, Claude Code, Pi, and OpenCode.
The backend coordinates work; daemons execute it on personal or managed computers, directly on the host or inside a BoxLite sandbox.
- Home and threads — See what needs your attention, follow live agent output, answer questions, and review results.
- Tasks and projects — Assign work, track priorities and due dates, and keep shared context, files, and run history together.
- Agents and teams — Choose runtimes, models, roles, and versioned skills. Work Solo, Build → Review, Pipeline, or Lead-led.
- Automations — Trigger work on a schedule, from task or run events, through a webhook, or with Run now.
- Connections and MCP — Give work scoped access to GitHub issue reads. Agents can manage standalone tasks and automations through Relay MCP; Project Leads can manage project work.
- Computers and administration — Manage execution hosts, runtime readiness, users, activity, and token usage.
- Desktop and mobile — Use responsive views in the browser or install Relay as an app.
Current UI, dark theme, demo data. Regenerate with capture.mjs; add --mobile for phone views.
You need Node.js 22.19+, npm, Python 3.12+, uv, and PostgreSQL. For the default BoxLite sandbox, you also need Docker, hardware virtualization, and credentials for the agents you plan to use.
Run the following commands from the repository root.
npm install
npm run buildCopy the environment examples and add your agent credentials (details in Local Development):
cp backend/.env.example backend/.env
cp web/.env.example web/.env.local
cp packages/.env.example packages/.envRelay stores sessions, tasks, events, and artifacts in PostgreSQL. Create the role and database specified by RELAY_DATABASE_URL in backend/.env. The example uses role relay and database relay on localhost:5432. Then apply the migrations:
make backend-migrateCreate the first admin account (there is no default password):
script/init_users.sh --email 'admin@example.com' --password 'choose-a-strong-password'Start each service in its own terminal:
make backend # control plane on 127.0.0.1:8790
make daemon SANDBOX_ID=node_dev # execution node connected to the backend
make web # web UI on 127.0.0.1:5000Open http://127.0.0.1:5000 and sign in as admin.
Tests, database migrations, the supervisor, pre-commit hooks, and shutdown commands are covered in Local Development.
Documentation · Local development · Deployment · Contributing
Apache-2.0. Third-party components and assets retain their own licenses.