A remote dashboard for Claude Code. Connect your Claude Code sessions to a relay server and manage them from anywhere — chat, view replies, and approve permission prompts from your phone.
Built on Claude Code's channels API.
After deploying, set the RELAY_TOKEN environment variable in your platform's dashboard. This is the password for both the web UI and your Claude Code connections.
Add the marketplace and install the plugin:
/plugin marketplace add vibesrc/claude-relay
/plugin install relay
Then configure your relay URL and token:
/relay:url wss://your-relay-url.example.com/ws
/relay:token your-secret
Check your config anytime with /relay:configure.
Start Claude Code with the channel enabled:
claude --dangerously-load-development-channels plugin:relay@claude-relayYour session will appear in the dashboard automatically.
- Multi-session — manage Claude Code across all your projects from one place
- Two-way chat — send messages to Claude and see replies with full markdown
- Permission relay — approve or deny tool use (Bash, Write, etc.) from your phone
- Typing indicators — see when Claude is working
- Persistent history — chat history survives restarts
- Smart sessions — sessions are named after your project directory and reclaimed on reconnect
- Mobile-friendly — responsive dashboard that works on any device
RELAY_TOKEN=your-secret docker compose up -dOr run directly with Bun:
bun install
RELAY_TOKEN=your-secret bun run relay| Variable | Default | Description |
|---|---|---|
RELAY_TOKEN |
— | Password for the dashboard and connections |
RELAY_URL |
ws://localhost:4080/ws |
Relay URL (set in Claude Code config) |
PORT |
4080 |
Server port (self-hosting only) |