> ## 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.

# Core Commands

> Essential Overdeck commands for system management

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" />
  </>;

# Core Commands

Core system management commands for Overdeck.

## pan install

Install prerequisites and perform first-time setup.

```bash theme={null}
# Full install (includes Traefik + mkcert for HTTPS)
pan install

# Minimal install (skip Traefik, use ports)
pan install --minimal
```

This command:

* Installs ttyd (web terminal)
* Installs the tools Overdeck needs for managed workspaces
* Optionally sets up Traefik and mkcert for HTTPS
* Creates necessary configuration directories
* Sets up git hooks for registered projects

## pan sync

Sync skills and configuration to all AI tools.

```bash theme={null}
pan sync
```

This command:

* Copies skills from `~/.overdeck/skills/` to AI tool directories
* Updates Claude Code skills in `~/.claude/skills/`
* Syncs to Codex, Cursor, Gemini CLI, and Google Antigravity
* Installs/updates git hooks in all registered projects

Run this after:

* Installing Overdeck
* Updating skills
* Adding new projects
* Upgrading Overdeck

## pan doctor

Check system health and configuration.

```bash theme={null}
pan doctor
```

Checks:

* Node.js version (22+ required)
* Git installation
* Docker installation and status
* tmux installation
* Required CLI tools (gh, glab)
* Configuration files
* API key validity
* Workspace health
* Traefik status (if installed)

Returns a health report with recommendations for any issues found.

## pan hygiene

Audit commits, working-tree changes, pull requests, agents, tmux sessions,
merged branches, stale workspaces, and disk headroom in one report. See the
[Hygiene Check](/cli/hygiene) reference for safe-fix semantics.

```bash theme={null}
pan hygiene
pan hygiene --strict
```

## pan up

Start the Overdeck dashboard and services.

```bash theme={null}
# Start with default settings
pan up

# Minimal mode (without Traefik)
pan up --minimal
```

Starts:

* **Frontend** - React dashboard (default: [http://localhost:3010](http://localhost:3010))
* **API Server** - Backend API (default: [http://localhost:3011](http://localhost:3011))
* **Traefik** - Reverse proxy (if installed)

With HTTPS enabled:

* Dashboard: [https://overdeck.localhost](https://overdeck.localhost)
* Traefik UI: [https://traefik.overdeck.localhost:8080](https://traefik.overdeck.localhost:8080)

The dashboard provides:

* Kanban board of issues
* Agent monitoring
* Real-time activity logs
* Cost tracking
* Skills browser
* Health checks

Beyond the board, the dashboard is where you watch and steer live agent
conversations and the work moving through the pipeline. The Pipeline page
groups every active issue by phase — Ship, Review, and Verifying — above a
metric strip tracking active issues, work running, the review queue, ship
count, and spend, with a live activity feed alongside.

<ThemedImage light="/images/dashboard/pipeline-light.png" dark="/images/dashboard/pipeline-dark.png" alt="Pipeline page: a metric strip (Active issues, Work running, Review queue, Ship, Spend) over phase-grouped issue rows for Ship, Review, and Verifying, with an activity feed on the right" />

<Tip>
  The metric strip is the fastest way to answer "where are we?" at a glance —
  it surfaces how many agents are working, how deep the review queue is, and
  the running spend without opening any individual issue.
</Tip>

## pan down

Stop the dashboard and services gracefully.

```bash theme={null}
pan down
```

This command:

* Stops the frontend and API server
* Optionally stops Traefik
* Does NOT stop running agents (use `pan work kill` for that)
* Does NOT affect workspaces or containers

Agents continue running independently in tmux sessions.

## pan restart

Restart the dashboard (frontend and API server).

```bash theme={null}
pan restart
```

This is a clean restart that:

* Kills old processes
* Frees ports (3010, 3011)
* Waits for API health check
* Starts fresh instances

Use this when:

* Dashboard becomes unresponsive
* API is not responding
* After upgrading Overdeck
* To clear any stuck state

## pan health

Check the health of all Overdeck services.

```bash theme={null}
pan health
```

Shows status of:

* Dashboard (frontend) - Running/stopped
* API server - Running/stopped + health endpoint check
* Traefik - Running/stopped (if installed)
* Running agents - Count and session IDs
* Workspaces - Count and disk usage
* Docker containers - Count and status

Returns:

* Exit code 0 if all services healthy
* Exit code 1 if any service is down

Useful for:

* Pre-flight checks before spawning agents
* Monitoring in automation scripts
* Troubleshooting issues

## Next Steps

* [Agent Commands](/cli/agent-commands) - Spawn and manage agents
* [Workspace Commands](/cli/workspace-commands) - Manage workspaces
* [CLI Overview](/cli/overview) - Learn more about the CLI