HEXCORE
Docs

Getting Started

Hexdeck is a control plane for AI coding operators. It provides live awareness, conflict prevention, and shared context so operators can work in parallel without stepping on each other.

Install the CLI

npm install -g @hexdeck/cli

Start the server

hex start

This launches the Hexdeck server in the background on http://localhost:3002. On macOS, it also opens the dashboard in your browser automatically.

What you'll see

The dashboard shows:

  • Workstreams — active operator sessions and what they're working on
  • Intent map — a visual overview of file-level activity
  • Live feed — real-time events from all operators
  • Risk — collision detection and conflict alerts

Menu bar app (macOS)

For a lightweight, always-visible alternative to the browser dashboard, install the Hexdeck menu bar app:

brew tap wagmint/hexdeck
brew install --cask hexdeck

The menu bar app shows a color-coded tray icon that reflects the overall state of your agents:

  • Blue — an agent is actively working
  • Green — agents are online, no issues
  • Yellow — something needs attention (e.g. high error rate)
  • Red — a critical issue (e.g. a collision between agents)
  • Grey — no active agents or disconnected

Click the icon to see a summary of active agents and current alerts. The menu bar app connects to the same Hexdeck server — you need the CLI running (hex start) for it to work.

Next steps

CLI Commands