> ## 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 = ""}) => {
  const [darkMode, setDarkMode] = useState(null);
  useEffect(() => {
    const root = document.documentElement;
    const syncTheme = () => setDarkMode(root.classList.contains("dark"));
    const observer = new MutationObserver(syncTheme);
    syncTheme();
    observer.observe(root, {
      attributes: true,
      attributeFilter: ["class"]
    });
    return () => observer.disconnect();
  }, []);
  if (darkMode === null) return null;
  return <img src={darkMode ? dark ?? light : light} alt={alt} loading="lazy" />;
};

# 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+** and **Claude Code** (signed in) are required.
* **git** is required.
* **Herdr** — the default terminal backend — is installed by `pan install`.
* **tmux** is needed only for plain terminals in the dashboard (and for agents when `terminal.backend: tmux`).
* **Docker**, **gh**, and **ast-grep** are optional; `pan install` warns instead of failing when they are missing.

The dashboard's Home page shows a **Get set up** card with what is still missing and the command to fix it.

## What Happens Next

1. **The dashboard opens on Home, in Simple mode** — no project required to start
2. **Type what you want** and press Enter to ask an agent, or Ctrl+Enter to run it in a terminal — still no project needed
3. **Add a project** — from the composer's project chip, or the Projects sidebar's `+`, when you want an agent working in a repo
4. **Pick an issue and start work** — select an open issue from the kanban board and Overdeck creates an isolated workspace for the agent
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.