Cloud Relay
Hexcore provides a relay server that connects multiple Hexdeck instances across different machines. This gives your team real-time visibility into operator activity regardless of location.
How it works
Each Hexdeck instance maintains a WebSocket connection to the cloud relay. Operator presence, plans, and activity metadata flow through the relay in real time. Hexcore is built for coordination signals, not syncing your repository history.
Setting up
1. Create a Hexcore
If you see waitlist gating, request access first or enter a beta code on the sign-in screen.
Sign in to Hexcore and click Create Hexcore on the dashboard. Give it a name that matches your project and choose your operator name. Your initial operator color is assigned automatically.
2. Generate an invite link
On the Hexcore detail page, an admin can open the Team dropdown and click Generate Invite Link. This creates a reusable hexcore+wss:// link that you can share with your team.
Share this link to invite & connect teammates
Copy the link — you'll paste this into Hexdeck on each machine that needs to connect.
3. Connect from Hexdeck
In the Hexdeck dashboard at localhost:7433, click RELAY in the top bar. This opens the relay panel on the right side.
Paste the invite link and click Connect.
If you're not yet a member of the Hexcore, Hexdeck will show an onboarding card. Click Open Hexcore to complete sign-in in your browser.
4. Join from the browser
If you're already a member (e.g. you created the Hexcore), the connection completes automatically. New teammates will see a join form to pick their operator name and color.
Join & Connect
Set up your operator identity to join this hexcore
Once you click Join & Connect, Hexdeck detects the completion and connects. You can close the browser tab.
Connected!
You can close this tab and return to Hexdeck.
5. You're connected
Back in the relay panel, a target card appears showing the connected Hexcore. Toggle which projects to share using the switches next to each active project.
Inviting teammates
Share the same invite link with your team. They paste it into their own Hexdeck relay panel and go through the same flow. The link is reusable — any number of people can join with it.
Connection status
The top bar in Hexdeck shows relay connection status next to the RELAY button:
- Green dot — all relay targets connected
- Blue dot (breathing) — some targets connected, some connecting
- Gray dot — no relay connections
The relay automatically handles reconnection with exponential backoff if the connection drops.
Troubleshooting
Operators not visible on the cloud dashboard: Make sure all team members have connected their Hexdeck to the same Hexcore and toggled on the same project in the relay panel.
Connection stuck on "Waiting": Check that you completed the sign-in and join flow in the browser. Hexdeck polls for completion automatically.
RELAY button is faded: No relay targets are configured yet. Paste a connect link to get started.