CLI Commands

pilot start [flags]

# Basic: Telegram + GitHub
pilot start --telegram --github
 
# With autopilot (auto-merge after CI)
pilot start --telegram --github --autopilot=stage
 
# With dashboard
pilot start --telegram --github --dashboard
 
# Sequential execution (wait for merge before next)
pilot start --github --sequential
 
# Production with auto-release
pilot start --github --autopilot=prod --auto-release
 
# With JSON logging for aggregation systems
pilot start --github --log-format=json
 
# Discord bot + GitHub
pilot start --discord --github
 
# Plane + GitHub
pilot start --plane --github
 
# Full stack: all adapters
pilot start --telegram --github --discord --plane --slack --dashboard

pilot task "description" [flags]

# Quick local execution
pilot task "Fix the typo in README.md"
 
# Preview what will happen
pilot task "Refactor auth module" --dry-run
 
# With verbose output
pilot task "Add rate limiting" --verbose
 
# With budget enforcement
pilot task "Implement caching" --budget
 
# Scoped to specific team
pilot task "Update API docs" --team=backend

pilot upgrade [subcommand]

pilot upgrade check [flags]

pilot upgrade run [flags]

pilot upgrade rollback

# Check for updates only
pilot upgrade check
 
# Upgrade (with confirmation)
pilot upgrade
 
# Upgrade without confirmation
pilot upgrade run --yes
 
# Force upgrade, skip task wait
pilot upgrade run --force
 
# Restore previous version
pilot upgrade rollback

pilot init [flags]

pilot doctor [flags]

# Run all checks
pilot doctor
 
# Show detailed output
pilot doctor --verbose

pilot logs [task-id] [flags]

# Show recent task logs
pilot logs
 
# Show last 20 tasks
pilot logs --limit 20
 
# Show logs for specific task
pilot logs TASK-12345
 
# Show logs for GitHub issue task
pilot logs GH-15
 
# JSON output
pilot logs --json

pilot status [flags]

# Show human-readable status
pilot status
 
# Output as JSON (for scripts)
pilot status --json
 
# Parse JSON with jq
pilot status --json | jq '.adapters'

📊 Pilot Status
───────────────────────────────────────
Gateway: http://localhost:8080

Adapters:
  ✓ Telegram (enabled)
  ○ Linear (disabled)
  ○ Slack (disabled)
  ✓ GitHub (enabled)

Projects:
  • pilot: /Users/dev/pilot [Context]
  • webapp: /Users/dev/webapp

pilot setup [flags]

# Full interactive setup
pilot setup
 
# Quick setup (skip optional features)
pilot setup --skip-optional
 
# Set up Cloudflare Tunnel for webhooks
pilot setup --tunnel
 
# Disable Mac sleep for always-on server
pilot setup --no-sleep

pilot config <subcommand>

pilot config show [flags]

# Show config as YAML
pilot config show
 
# Show config as JSON
pilot config show --json
 
# Pipe to tools
pilot config show --json | jq '.projects'

pilot config edit

# Open in default editor
pilot config edit
 
# Use specific editor
EDITOR=code pilot config edit
EDITOR=nano pilot config edit

pilot config validate [flags]

# Validate with full output
pilot config validate
 
# Silent validation for scripts
if pilot config validate --quiet; then
  echo "Config OK"
else
  echo "Config invalid"
fi

Config: ~/.pilot/config.yaml

Syntax:     OK
Validation: OK

Warnings:
  - GitHub enabled but token not set
  - Project path does not exist: /old/project

pilot config path

# Show path
pilot config path
# Output: /Users/dev/.pilot/config.yaml
 
# Use in scripts
cat "$(pilot config path)"
 
# Back up config
cp "$(pilot config path)" config-backup.yaml

pilot completion <shell>

# Load for current session
source <(pilot completion bash)
 
# Install permanently (Linux)
pilot completion bash > /etc/bash_completion.d/pilot
 
# Install permanently (macOS with Homebrew)
pilot completion bash > $(brew --prefix)/etc/bash_completion.d/pilot

# Enable completion (if not already enabled)
echo "autoload -U compinit; compinit" >> ~/.zshrc
 
# Install completion
pilot completion zsh > "${fpath[1]}/_pilot"
 
# Start new shell for changes to take effect

# Load for current session
pilot completion fish | source
 
# Install permanently
pilot completion fish > ~/.config/fish/completions/pilot.fish

# Load for current session
pilot completion powershell | Out-String | Invoke-Expression
 
# Install permanently (add to profile)
pilot completion powershell > pilot.ps1
# Then source from PowerShell profile

pilot version

pilot version
# Output:
# Pilot v2.56.0
# Built: 2026-03-01T10:30:00Z

pilot github run <issue-number> [flags]

# Execute issue #8
pilot github run 8
 
# Execute from specific repository
pilot github run 8 --repo owner/repo
 
# Preview execution
pilot github run 8 --dry-run
 
# With verbose output
pilot github run 8 --verbose

pilot brief [flags]

# Show scheduler status
pilot brief
 
# Generate and send brief immediately
pilot brief --now
 
# Generate a weekly summary
pilot brief --weekly

pilot replay <subcommand>

pilot replay list [flags]

# List recent recordings
pilot replay list
 
# Show only last 10
pilot replay list --limit 10
 
# Filter by project
pilot replay list --project pilot
 
# Show only failed executions
pilot replay list --status error

pilot replay show <recording-id>

# Show recording details
pilot replay show TG-1234567890
 
# Example output includes:
# - Basic info (task ID, duration, token usage)
# - Phase breakdown
# - Tool usage statistics
# - Error summary (if any)

pilot replay play <recording-id> [flags]

# Interactive replay
pilot replay play TG-1234567890
 
# Start from event 50
pilot replay play TG-1234567890 --start 50
 
# Simple output mode (no TUI)
pilot replay play TG-1234567890 --no-tui
 
# Show verbose details
pilot replay play TG-1234567890 --verbose

pilot replay analyze <recording-id>

# Analyze execution
pilot replay analyze TG-1234567890
 
# Output includes:
# - Token usage breakdown by phase
# - Tool usage patterns
# - Performance bottlenecks
# - Error analysis and recommendations

pilot replay export <recording-id> [flags]

# Export as HTML
pilot replay export TG-1234567890
 
# Export with analysis
pilot replay export TG-1234567890 --with-analysis
 
# Export as JSON
pilot replay export TG-1234567890 --format json
 
# Export as Markdown
pilot replay export TG-1234567890 --format markdown
 
# Custom output file
pilot replay export TG-1234567890 --output report.html

pilot replay delete <recording-id> [flags]

# Delete with confirmation
pilot replay delete TG-1234567890
 
# Force delete without confirmation
pilot replay delete TG-1234567890 --force

pilot patterns <subcommand>

pilot patterns list [flags]

# List top patterns
pilot patterns list
 
# Show high-confidence patterns only
pilot patterns list --min-confidence 0.8
 
# Show anti-patterns
pilot patterns list --show-anti
 
# Limit results
pilot patterns list --limit 20

pilot patterns search <query>

# Search for authentication patterns
pilot patterns search "authentication"
 
# Search for error handling patterns
pilot patterns search "error handling"
 
# Search for specific technologies
pilot patterns search "React hooks"

pilot patterns stats

# Show pattern statistics
pilot patterns stats
 
# Example output:
# Total patterns: 247
# High confidence (>0.8): 89 patterns
# Success patterns: 198
# Anti-patterns: 49
# Projects covered: 12

pilot budget <subcommand>

pilot budget status [flags]

# Show budget status
pilot budget status
 
# Show as JSON
pilot budget status --json
 
# Show for specific project
pilot budget status --project pilot

📊 Budget Status (January 2026)
─────────────────────────────────────
Monthly Limit: $100.00
Used:          $23.45 (23%)
Remaining:     $76.55

Projects:
  • pilot:    $15.20 (65%)
  • webapp:   $8.25 (35%)

Alerts: ✓ 50% threshold, ✓ 75% threshold

pilot budget config [flags]

# Set monthly budget
pilot budget config --monthly $100
 
# Set daily limit
pilot budget config --daily $5
 
# Configure alert threshold
pilot budget config --alert-threshold 80
 
# Set project-specific limit
pilot budget config --project pilot --monthly $50
 
# Disable budget enforcement
pilot budget config --disable

pilot budget reset [flags]

# Reset all budget counters
pilot budget reset
 
# Reset without confirmation
pilot budget reset --force
 
# Reset specific project
pilot budget reset --project pilot

pilot metrics <subcommand>

pilot metrics summary [flags]

# Show 30-day summary
pilot metrics summary
 
# Show weekly summary
pilot metrics summary --period 7d
 
# Export as JSON
pilot metrics summary --json

📈 Metrics Summary (30 days)
─────────────────────────────────────
Tasks Completed: 127
Success Rate:     94.5%
Avg Duration:     4m 32s

Token Usage:
  Input:  1,234,567 tokens
  Output:   567,890 tokens
  Total:  1,802,457 tokens

Top Projects:
  1. pilot (45 tasks)
  2. webapp (32 tasks)
  3. api (28 tasks)

pilot metrics daily [flags]

# Show 14-day daily breakdown
pilot metrics daily
 
# Show with ASCII charts
pilot metrics daily --chart
 
# Show last 30 days
pilot metrics daily --days 30

pilot metrics projects [flags]

# Show project metrics
pilot metrics projects
 
# Sort by token usage
pilot metrics projects --sort tokens
 
# Sort by success rate
pilot metrics projects --sort success

pilot metrics export [flags]

# Export as CSV
pilot metrics export
 
# Export as JSON with raw data
pilot metrics export --format json --include-raw
 
# Export to specific file
pilot metrics export --output metrics-jan2026.csv
 
# Export all historical data
pilot metrics export --period all --format excel

pilot usage <subcommand>

pilot usage summary [flags]

# Show usage summary
pilot usage summary
 
# Show with cost breakdown
pilot usage summary --breakdown
 
# Show weekly usage
pilot usage summary --period 7d

💰 Usage Summary (30 days)
─────────────────────────────────────
Total Cost:       $45.67
Token Cost:       $38.92 (85%)
Infrastructure:   $6.75 (15%)

API Calls:        2,847
Tokens Processed: 1,802,457
Avg Cost/Task:    $0.36

Model Usage:
  Claude-4.6:     $32.15 (84%)
  Claude-4.5:     $6.77 (16%)

pilot usage daily [flags]

# Show daily usage
pilot usage daily
 
# Show with cost charts
pilot usage daily --chart
 
# Show last 30 days
pilot usage daily --days 30

pilot usage projects [flags]

# Show project usage
pilot usage projects
 
# Sort by efficiency
pilot usage projects --sort efficiency --efficiency
 
# Show detailed metrics
pilot usage projects --efficiency

pilot usage events [flags]

# Show recent events
pilot usage events
 
# Show events for specific project
pilot usage events --project pilot
 
# Show expensive calls only
pilot usage events --min-cost 1.00
 
# Show events for specific model
pilot usage events --model claude-4.6

pilot usage export [flags]

# Export usage data
pilot usage export
 
# Export in billing format
pilot usage export --format billing
 
# Export grouped by project
pilot usage export --group-by project
 
# Export with metadata
pilot usage export --include-metadata --format json

pilot webhooks <subcommand>

pilot webhooks list [flags]

# List all webhooks
pilot webhooks list
 
# List GitHub webhooks only
pilot webhooks list --service github
 
# List inactive webhooks
pilot webhooks list --status inactive

🔗 Configured Webhooks
─────────────────────────────────────
GitHub:
  ✓ https://pilot.example.com/api/webhooks/github
    Events: issues, pull_requests
    Last ping: 2 hours ago

Linear:
  ✓ https://pilot.example.com/api/webhooks/linear
    Events: issue.create, issue.update
    Last ping: 15 minutes ago

GitLab:
  ⚠ https://pilot.example.com/api/webhooks/gitlab
    Events: issues, merge_requests
    Status: Connection error

pilot webhooks add <service> [flags]

# Add GitHub webhook
pilot webhooks add github --repo owner/repo
 
# Add with specific events
pilot webhooks add github --repo owner/repo --events issues,pull_requests
 
# Add Linear webhook
pilot webhooks add linear
 
# Add with custom URL
pilot webhooks add github --url https://custom.example.com/hook

pilot webhooks remove <service> [flags]

# Remove GitHub webhook
pilot webhooks remove github --repo owner/repo
 
# Remove without confirmation
pilot webhooks remove linear --force
 
# Remove from service only
pilot webhooks remove github --repo owner/repo --keep-config

pilot webhooks test <service> [flags]

# Test GitHub webhook
pilot webhooks test github --repo owner/repo
 
# Test specific event
pilot webhooks test github --repo owner/repo --event issues
 
# Test with verbose output
pilot webhooks test linear --verbose

pilot webhooks events [flags]

# Show recent webhook events
pilot webhooks events
 
# Show GitHub events only
pilot webhooks events --service github
 
# Show failed events
pilot webhooks events --status failed
 
# Show events from last 2 hours
pilot webhooks events --since 2h
 
# Show last 100 events
pilot webhooks events --limit 100

pilot team <subcommand>

pilot team create <name> [flags]

# Create a new team
pilot team create "Backend Team" --owner admin@example.com
 
# Output includes team ID and instructions for adding members

pilot team list

# List all teams
pilot team list
 
# Sample output:
# Found 2 team(s):
#
# ID        NAME           CREATED
# ──        ────           ───────
# abc12345  Backend Team   2026-01-15
# def67890  Frontend Team  2026-01-20

pilot team show <team-id>

# Show team by ID (partial match supported)
pilot team show abc12345
 
# Show team by name
pilot team show "Backend Team"
 
# Sample output:
# 📋 Team: Backend Team
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#    ID:         abc12345-...
#    Created:    2026-01-15 10:30
#    Max Tasks:  5 concurrent
#
# 👥 Members (2):
#    ID        EMAIL              ROLE       PROJECTS
#    mem123    admin@example.com  owner      all
#    mem456    dev@example.com    developer  all

pilot team delete <team-id> [flags]

# Delete team (with confirmation)
pilot team delete abc12345 --as owner@example.com
 
# Delete without confirmation
pilot team delete abc12345 --as owner@example.com --force

pilot team member <subcommand>

pilot team member add <team-id> <email> [flags]

# Add a developer with access to all projects
pilot team member add abc123 dev@example.com --role developer --as admin@example.com
 
# Add a viewer restricted to specific projects
pilot team member add abc123 viewer@example.com --role viewer --projects api,frontend --as admin@example.com

pilot team member remove <team-id> <member-email> [flags]

# Remove a member
pilot team member remove abc123 dev@example.com --as admin@example.com

pilot team member role <team-id> <member-email> <new-role> [flags]

# Promote a developer to admin
pilot team member role abc123 dev@example.com admin --as owner@example.com
 
# Demote to viewer
pilot team member role abc123 user@example.com viewer --as admin@example.com

pilot team project <subcommand>

pilot team project set <team-id> <project-path> [flags]

# Grant team access to a project
pilot team project set abc123 /path/to/project --role developer --as owner@example.com
 
# Set read-only access
pilot team project set abc123 /path/to/project --role viewer --as admin@example.com

pilot team project remove <team-id> <project-path> [flags]

# Remove project access
pilot team project remove abc123 /path/to/project --as admin@example.com

pilot team project list <team-id>

# List project access
pilot team project list abc123
 
# Sample output:
# 📂 Project Access for 'Backend Team' (2 entries):
#
# PROJECT PATH              DEFAULT ROLE
# ────────────              ────────────
# /home/dev/api             developer
# /home/dev/shared-utils    viewer

pilot team audit <team-id> [flags]

# View recent audit entries
pilot team audit abc123 --as admin@example.com
 
# View last 100 entries
pilot team audit abc123 --limit 100 --as admin@example.com
 
# Sample output:
# 📜 Audit Log for 'Backend Team' (showing 3 entries)
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# [2026-01-15 10:30] admin@example.com performed add_member on member (mem456)
# [2026-01-15 10:25] admin@example.com performed create_team on team (abc123)

pilot project <subcommand>

pilot project list

# List all projects
pilot project list
 
# Sample output:
# PROJECTS (2 configured)
#
#   NAME    PATH                    GITHUB           BRANCH  NAV  DEFAULT
#   pilot   /Users/dev/pilot        owner/pilot      main    *    *
#   webapp  /Users/dev/webapp       owner/webapp     main
#
# Use 'pilot project show <name>' for details

pilot project add [flags]

# Add project from current directory (auto-detect settings)
pilot project add --name my-app
 
# Add with explicit GitHub repository
pilot project add --name my-app --github owner/repo
 
# Add with custom path and branch
pilot project add -n my-app -p /path/to/project -g owner/repo -b develop
 
# Add and set as default
pilot project add --name primary-app --set-default

pilot project remove <name> [flags]

# Remove with confirmation
pilot project remove my-app
 
# Remove without confirmation
pilot project remove my-app --force
 
# Using flag instead of positional argument
pilot project remove --name my-app

pilot project set-default <name>

# Set default project
pilot project set-default my-app

pilot project show [name]

# Show specific project
pilot project show my-app
 
# Show default project
pilot project show
 
# Sample output:
# PROJECT: my-app
#
#   Path:       /Users/dev/my-app
#   GitHub:     owner/my-app
#   Branch:     main
#   Context:    enabled
#   Default:    yes

pilot tunnel <subcommand>

pilot tunnel status

# Show tunnel status
pilot tunnel status
 
# Sample output:
# Tunnel Status
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#   Provider:  cloudflare
#   Status:    ✓ Running
#   Connected: ✓ Yes
#   URL:       https://pilot-webhook.example.com
#   Tunnel ID: abc123-def456-...
#
# Service (launchd)
# ─────────────────────────────────────────
#   Installed: ✓ Yes
#   Running:   ✓ Yes (auto-starts on boot)

pilot tunnel start [flags]

# Start tunnel (background)
pilot tunnel start
 
# Start in foreground (Ctrl+C to stop)
pilot tunnel start --foreground
 
# Output:
# Starting cloudflare tunnel...
#
# ✓ Tunnel started
#   URL: https://pilot-webhook.example.com
#   Webhook endpoint: https://pilot-webhook.example.com/webhooks/github

pilot tunnel stop

# Stop tunnel
pilot tunnel stop
 
# Output: ✓ Tunnel stopped

pilot tunnel url [flags]

# Show base URL
pilot tunnel url
 
# Show full webhook URL
pilot tunnel url --webhook /webhooks/github

pilot tunnel setup [flags]

# Basic setup
pilot tunnel setup
 
# With custom domain
pilot tunnel setup --domain pilot.example.com
 
# With auto-start service
pilot tunnel setup --service
 
# Full setup with all options
pilot tunnel setup --domain pilot.example.com --service

pilot tunnel service <subcommand>

pilot tunnel service install

# Install service
pilot tunnel service install
 
# Output:
# Installing service... ✓
#
# Service installed!
#   - Tunnel will auto-start on boot
#   - Run 'pilot tunnel service status' to check

pilot tunnel service uninstall

# Uninstall service
pilot tunnel service uninstall
 
# Output:
# Uninstalling service... ✓
# Service removed - tunnel will no longer auto-start

pilot tunnel service status

# Show service status
pilot tunnel service status
 
# Sample output:
# Service Status (launchd)
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#   Installed: ✓ Yes
#   Path:      ~/Library/LaunchAgents/com.pilot.tunnel.plist
#   Running:   ✓ Yes

pilot autopilot <subcommand>

pilot autopilot status [flags]

# Show autopilot status
pilot autopilot status
 
# Sample output:
# 🤖 Autopilot Status
# ───────────────────────────────────────
# Environment: stage
#
# Configuration:
#   Auto Merge:     true
#   Auto Review:    false
#   Merge Method:   squash
#   CI Timeout:     10m0s
#   Max Failures:   3
#
# Release:
#   Enabled:        true
#   Trigger:        on-merge
#   Require CI:     true
#   Tag Prefix:     v
#
# ℹ️  For live PR tracking, check:
#    • Dashboard: pilot start --dashboard --autopilot=<env>
#    • Logs: pilot logs --follow
 
# JSON output
pilot autopilot status --json

pilot release [version] [flags]

# Auto-detect version from commits
pilot release
 
# Force minor bump
pilot release --bump=minor
 
# Specific version
pilot release v1.2.3
 
# Create as draft
pilot release --draft
 
# Preview release without creating
pilot release --dry-run
 
# Output:
# Would create release:
#   Current version: v2.56.0
#   New version: v2.56.1
#   Bump type: patch
#   Draft: false

pilot allow [user_id] [flags]

# Add a user
pilot allow 123456789
 
# Remove a user
pilot allow --remove 123456789
 
# List allowed users
pilot allow --list
 
# Sample output:
# Allowed Telegram users:
#   123456789
#   987654321
#
# Total: 2 user(s)