Skip to main content

​
Core Commands

Core system management commands for Overdeck.

​
pan install

Install prerequisites and perform first-time setup.
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
The prerequisite gate only fails on Node, git, and (under the tmux backend) tmux. Docker, ast-grep, and (under Herdr) tmux print a yellow warning instead of failing, and installation continues.

​
pan sync

Sync skills and configuration to all AI tools.
This command:
  • Copies skills from ~/.overdeck/skills/ to AI tool directories
  • Updates Claude Code skills in ~/.claude/skills/
  • Prunes managed cache and target files when their bundled source is removed
  • Preserves user-owned files and reports user-modified stale files instead of deleting them
  • Skips empty bundled skill directories instead of propagating them into caches
  • 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.
Checks:
  • Node.js version (22+ required)
  • Git installation
  • Docker installation and status
  • tmux installation (a warning, not an error, when Herdr is the terminal backend)
  • Claude Code and GitHub CLI login state (warnings)
  • 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 reference for safe-fix semantics.

​
pan up

Start the Overdeck dashboard and services.
Starts: With HTTPS enabled: 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.
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.

​
pan down

Stop the dashboard and services gracefully.
This command:
  • Stops the frontend and API server
  • Optionally stops Traefik
  • Does NOT stop running agents (use pan 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).
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.
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