Skip to main content

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.

​
CLI Overview

The Panopticon CLI (pan) provides a comprehensive set of commands for managing agents, workspaces, and multi-project orchestration.

​
Philosophy

The Panopticon CLI is designed around a few key principles:
  1. Agent-centric - Commands focus on spawning, monitoring, and controlling AI agents
  2. Workspace isolation - Each issue gets its own git worktree workspace
  3. Multi-project support - Manage multiple projects from a single installation
  4. Integration-first - Works seamlessly with GitHub, Linear, GitLab, and Rally

​
Command Structure

Panopticon commands are organized into logical groups:
GroupPurposeExamples
CoreSystem managementpan up, pan down, pan sync, pan doctor
WorkAgent managementpan work issue, pan work status, pan work tell
WorkspaceWorkspace lifecyclepan workspace create, pan workspace destroy
ConvoyMulti-agent orchestrationpan convoy start, pan convoy status
ProjectProject registrypan project add, pan project list
SpecialistsSpecialist agent managementpan specialists status, pan specialists wake
RemoteRemote workspace managementpan remote init, pan remote status
CloisterAI lifecycle managerpan cloister start, pan cloister status

​
Installation & Setup

# Install Panopticon globally
npm install -g @panctl/cli

# 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 work issue MIN-123      # Spawn agent
pan work tell MIN-123 "msg" # Send message
pan work status             # List all agents
pan work 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 work --help
pan workspace --help

# Command documentation
man pan              # If installed via package manager

​
Common Options

​
Global flags

FlagDescription
--helpShow help for any command
--versionShow Panopticon version
--verboseEnable 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

Panopticon stores configuration in:
  • ~/.panopticon.env - API keys and tokens
  • ~/.panopticon/projects.yaml - Registered projects
  • ~/.panopticon/project-mappings.json - Linear project mappings
  • Project-level: .panopticon.json - Project-specific settings

​
Next Steps