CLI Overview

The Overdeck CLI (pan) provides a comprehensive set of commands for managing agents, workspaces, and multi-project orchestration. Every CLI command has a counterpart in the dashboard, where the same agents, conversations, and workflow are managed visually. The Command Deck below shows a live agent: the project and conversation sidebar on the left, the issue tree, the agent’s turn-by-turn tool calls and reasoning in the center, and a Needs-you / Project / Global awareness rail on the right.

The CLI and dashboard operate on the same state. You can spawn an agent from the terminal with pan start MIN-123 and watch its reasoning stream into the Command Deck, or start it from the board and drive it from the CLI — they are two views of one orchestrator.

Philosophy

The Overdeck CLI is designed around a few key principles:

Agent-centric - Commands focus on spawning, monitoring, and controlling AI agents
Workspace isolation - Each issue gets its own git worktree workspace
Multi-project support - Manage multiple projects from a single installation
Integration-first - Works seamlessly with GitHub, Linear, GitLab, and Rally

Command Structure

Overdeck commands are organized into logical groups:

Group	Purpose	Examples
Core	System management	`pan up`, `pan down`, `pan sync`, `pan doctor`
Work	Agent management	`pan start`, `pan status`, `pan tell`, `pan kill`
Workspace	Workspace lifecycle	`pan workspace create`, `pan workspace destroy`
Review	Code review loop	`pan review request`, `pan review restart`, `pan review abort`
Project	Project registry	`pan project add`, `pan project list`
Conversations	Session history and conversation metadata	`pan conv list`, `pan conv move`, `pan conv link-pr` (linking pull requests)
Admin	Specialists, remote workspaces, Cloister	`pan admin specialists list`, `pan admin remote status`, `pan admin cloister status`

Installation & Setup

# Install Overdeck globally
npm install -g @overdeck/core

# Run first-time setup
pan install

# Sync skills to AI tools
pan sync

# Check system health
pan doctor

Common Patterns

Issue-based workflows

Most commands accept an issue identifier (e.g., MIN-123, 42):

pan start MIN-123           # Spawn agent
pan tell MIN-123 "msg"      # Send message
pan status                  # List all agents
pan kill MIN-123            # Stop agent

Workspace management

Workspaces are git worktrees created automatically or on-demand:

pan workspace create MIN-123         # Create workspace
pan workspace create MIN-123 --docker # With Docker containers
pan workspace destroy MIN-123        # Clean up workspace

Dashboard integration

Many operations can be performed either via CLI or dashboard:

pan up    # Start dashboard at localhost:3011

The dashboard provides a visual interface for all CLI operations.

Getting Help

# General help
pan --help

# Command-specific help
pan start --help
pan workspace --help

# Command documentation
man pan              # If installed via package manager

Common Options

Global flags

Flag	Description
`--help`	Show help for any command
`--version`	Show Overdeck version
`--verbose`	Enable verbose output

Issue identifiers

Commands accept various issue identifier formats:

Linear: MIN-123, min-123 (case-insensitive)
GitHub: #42, 42 (numeric)
GitLab: !42, 42 (numeric)

Configuration

Overdeck stores configuration in:

~/.overdeck.env - API keys and tokens
~/.overdeck/projects.yaml - Registered projects
~/.overdeck/project-mappings.json - Linear project mappings
Project-level: .overdeck.json - Project-specific settings

Next Steps

Core Commands - System management commands
Agent Commands - Manage AI agents
Workspace Commands - Workspace management
Review Commands - Request, restart, and abort code review
pan vault - Session Vault: save and continue conversations on another machine
pan pair - Pair another device with this machine’s dashboard
pan devices - List and revoke paired devices
pan token - Scoped API tokens for programs

​CLI Overview

​Philosophy

​Command Structure

​Installation & Setup

​Common Patterns

​Issue-based workflows

​Workspace management

​Dashboard integration

​Getting Help

​Common Options

​Global flags

​Issue identifiers

​Configuration

​Next Steps

CLI Overview

Philosophy

Command Structure

Installation & Setup

Common Patterns

Issue-based workflows

Workspace management

Dashboard integration

Getting Help

Common Options

Global flags

Issue identifiers

Configuration

Next Steps