> ## Documentation Index
> Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get Command Deck running in one command

export const ThemedImage = ({light, dark, alt = ""}) => <>
    <img src={light} alt={alt} className="block dark:hidden" />
    <img src={dark ?? light} alt={alt} className="hidden dark:block" />
  </>;

# Quick Start

<ThemedImage light="/images/dashboard/command-deck-hero-light.png" dark="/images/dashboard/command-deck-hero-dark.png" alt="Command Deck showing a live agent conversation: project and conversation sidebar, the issue tree, the agent's turn-by-turn tool calls and reasoning, and the Needs-you / Project / Global awareness rail." />

## One Command

```bash theme={null}
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

<ThemedImage light="/images/dashboard/board-light.png" dark="/images/dashboard/board-dark.png" alt="The kanban board: issue columns with per-issue cost badges, agent status dots, and inline workspace controls." />

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:

```bash theme={null}
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):

```bash theme={null}
npm install -g @overdeck/core
overdeck install   # installs tmux, ttyd, mkcert, gh, glab, 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](https://github.com/eltmon/overdeck/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.