Skip to main content

​
Quick Start

​
One Command

npx @overdeck/core
That’s it. npx @overdeck/core starts Command Deck and opens the dashboard in your browser. No global install step required. Missing tools (tmux, gh, mkcert, etc.) are prompted and installed inline the first time you use a feature that needs them.

​
Requirements

  • Node.js 22+ — the only prerequisite

​
What Happens Next

  1. Command Deck opens — Overdeck launches the local server and opens the dashboard in your browser
  2. Add a project — click the project picker and point Overdeck at a GitHub or GitLab repo
  3. Pick an issue — select an open issue from the kanban board
  4. Spawn an agent — Overdeck creates an isolated workspace and the agent starts planning and coding
  5. Stay in control — watch diffs land as the agent works, send messages to steer it, swap models if the task shifts, fork the conversation to explore alternatives
The board is the usual place to pick an issue: each card carries a cost badge, a live agent status dot, and workspace controls, so you can spawn or check in on an agent without leaving the column it lives in. Work at whatever level of involvement you want. Pair-program hands-on with a single agent in the conversation view above, or let the specialist pipeline take issues from plan to merged PR while you focus elsewhere — Command Deck is built to manage both the agents and the workflow they move through.

​
Headless / CI

For terminals, scripts, and CI where you don’t need the GUI: 
npm install -g @overdeck/core
overdeck up        # start dashboard server
overdeck work PAN-123   # spawn agent for an issue
pan is a built-in short alias for overdeck — every overdeck <verb> also works as pan <verb> (same binary). Use whichever you like; pan is handy for headless, CI, and existing muscle memory.

​
Power-User Path: Install Everything Up Front

If you prefer to set up all tools at once (useful for shared dev machines or CI images): 
npm install -g @overdeck/core
overdeck install   # installs tmux, ttyd, mkcert, gh, glab, beads, claudish, ox
overdeck sync      # sync skills/agents/rules to ~/.overdeck/
overdeck up        # start Traefik + dashboard

​
Direct Desktop Downloads

Prefer a standalone app? Download the latest release for your platform:
  • Linux — .AppImage from GitHub Releases
  • macOS — .dmg (universal, arm64 + x64)
  • Windows — .exe (NSIS installer)

​
Architecture at a Glance

Overdeck started as a CLI and grew into Command Deck, a desktop-class development environment. The CLI, the GUI, and any script that can make an HTTP request all drive the same REST surface — spawn an agent from a kanban card, a terminal, or a webhook without switching tools. Under the hood: an Effect.js + TypeScript server, a React frontend over typed WebSocket RPC, SQLite for state, and Electron as the shell. Launch with npx @overdeck/core or the overdeck command (pan is its short alias); use @overdeck/desktop for the packaged desktop app.