Getting Started
Hexdeck is a control plane for AI coding operators. It provides live awareness of what your agents are doing, so you can run multiple operators in parallel with confidence.
Install
Floating widget + full dashboard at localhost:7433
Launch Hexdeck from your Applications folder. It runs as a floating widget on your desktop and automatically starts the server in the background. The full dashboard is available at http://localhost:7433.
Status widget
The floating hexagon widget reflects the overall state of your agents:
The blue state includes a subtle breathing animation to draw your attention when an agent needs approval. Click the widget to expand it and see a summary of active agents and current alerts.
Widget controls
The floating widget supports quick interactions:
| Action | Result |
|---|---|
| Click the hexagon widget | Opens the expanded card view |
| Drag the hexagon (or card header) | Moves the widget window |
Notes:
- Widget position is saved after you drag it, so it stays where you left it.
Keyboard shortcuts
Hexdeck includes optional global shortcuts:
| Shortcut | Action |
|---|---|
Cmd + Ctrl + H | Toggle the Hexdeck popup window |
Cmd + Ctrl + K | Show or hide the floating widget |
Esc (while widget card is open) | Collapse back to the hexagon |
Dashboard
Open localhost:7433 in your browser for the full dashboard. It updates in real time via SSE as your agents work.
The dashboard has four panels:
- Workstreams — active operator sessions grouped by project, with agent status and task progress
- Intent map — a high-level view of what each workstream is doing, planned vs. actual work, and drift detection
- Live feed — a chronological stream of events: commits, errors, completions, plan changes, and collisions
- Risk — per-agent health metrics including context usage, error rate, cost tracking, and stall detection
Next steps
- Learn about privacy and data handling
- Ready for multi-machine coordination? See Cloud Relay setup