CLI Reference

Complete CLI reference for QUESTPIE Autopilot — init, start, ask, attach, inbox, agents, status, secrets, provider, dashboard, git, and more.

Complete command reference for the autopilot CLI. Your terminal into the AI company.

Installation

terminal

# Install globally
bun add -g @questpie/autopilot

# Or run directly (no install)
bunx @questpie/autopilot init my-company

kubectl Analogy

If you know Kubernetes, you already know Autopilot. Agents are pods, the orchestrator is the control plane, tasks are workloads.

kubectl	autopilot	What it does
`kubectl create ns`	`autopilot init`	Create workspace
`kubectl apply -f ...`	`autopilot ask "..."`	Submit work
`kubectl get pods`	`autopilot agents`	List workers
`kubectl logs -f pod/web`	`autopilot attach max`	Live-stream output
`kubectl get jobs`	`autopilot tasks`	List workloads
`kubectl get events`	`autopilot inbox`	Items needing attention

Setup Commands

autopilot init

Scaffold a new company directory from a template.

syntax

autopilot init [name] [options]

Arguments:
  name                    Company name (default: "My Company")

Options:
  -f, --force             Overwrite existing directory

autopilot start

Start the orchestrator process. Launches the FS watcher, workflow engine, scheduler, webhook server, and session streaming.

syntax

autopilot start [options]

Options:
  -p, --port <port>       Webhook server port (default: 7777)

Environment:
  OPENROUTER_API_KEY       Required. Your Anthropic API key.

autopilot status

Display a company overview: agent roster, task counts by status, and totals.

Intent & Task Commands

autopilot ask

Submit a high-level intent. Creates a task of type intent in the backlog assigned to the CEO agent.

syntax

autopilot ask <intent>

autopilot tasks

List all tasks. Filter by status or assigned agent.

syntax

autopilot tasks [options]
autopilot tasks show <id>
autopilot tasks approve <id>
autopilot tasks reject <id> [reason]

Options:
  -s, --status <status>   Filter: backlog, active, review, blocked, done
  -a, --agent <agent>     Filter by assigned agent ID

autopilot inbox

Show tasks requiring human attention. Displays all tasks in review or blocked status.

Agents & Observation

autopilot agents

List all defined agents with their role, name, ID, and model.

syntax

autopilot agents
autopilot agents show <id>

autopilot attach

Live-stream an agent's activity feed. Like kubectl logs -f. Press Ctrl+C to detach.

syntax

autopilot attach <agent> [options]

Options:
  --compact               One line per event
  --tools-only            Only show tool_call and tool_result events

autopilot replay

Replay an agent's past activity.

syntax

autopilot replay <agent> [options]

Options:
  --limit <n>             Number of entries to show (default: 50)

Knowledge & Config

autopilot knowledge

Manage the company knowledge base.

syntax

autopilot knowledge                        List knowledge tree
autopilot knowledge show <path>            Print a knowledge doc
autopilot knowledge add <path> [--file f]  Add a doc
autopilot knowledge scan                   Show parsed skill catalog

autopilot secrets

Manage secrets for integrations.

syntax

autopilot secrets                           List secret names
autopilot secrets list                     List with type and agent scope
autopilot secrets add <name> [options]     Add a secret
autopilot secrets remove <name>            Remove a secret

autopilot board

View and manage dashboard pins created by agents.

syntax

autopilot board                             List all pins
autopilot board clear                      Remove all pins

autopilot provider

Manage AI provider authentication. Supports direct API key configuration and status checks.

syntax

autopilot provider set <provider> [opts]  Set an API key directly
autopilot provider status                 Show which providers are configured
autopilot provider logout <provider>      Clear provider credentials

Providers:
  openrouter              OpenRouter — one key, 300+ models

Options for set:
  --api-key <key>         API key for the provider (required)

examples

# Check which providers are configured
autopilot provider status

# Set your OpenRouter API key
autopilot provider set openrouter --api-key sk-or-...

# Remove credentials for a provider
autopilot provider logout openrouter

Communication

autopilot channels

List, read, and send messages to agent communication channels.

syntax

autopilot channels                          List all channels
autopilot channels show <channel>          Show messages
autopilot channels send <channel> "msg"    Send a message

Options for show:
  -n, --limit <n>         Number of messages (default: 20)
  -f, --follow            Live follow mode

autopilot chat

Send a message to a specific agent and get a streamed response.

syntax

autopilot chat <agent> <message> [options]

Options:
  -c, --channel <channel> Channel to load history from (default: general)

autopilot approve / reject

Top-level shortcuts for task approval and rejection. Triggers workflow advancement.

syntax

autopilot approve <task-id>
autopilot reject <task-id> [reason]

Dashboard

autopilot dashboard

Manage the Living Dashboard. Running autopilot dashboard with no subcommand opens the dashboard in your browser.

syntax

autopilot dashboard                        Open dashboard in browser
autopilot dashboard dev                    Start Vite dev server with HMR
autopilot dashboard build                  Build dashboard for production
autopilot dashboard reset                  Reset to default (removes overrides, widgets, pages)
autopilot dashboard widgets                List custom dashboard widgets
autopilot dashboard pages                  List custom dashboard pages

examples

# Start the dashboard in dev mode with hot reload
autopilot dashboard dev

# Build static files for production
autopilot dashboard build

# List all custom widgets
autopilot dashboard widgets

# Reset dashboard customizations back to defaults
autopilot dashboard reset

Git

autopilot git

Git operations for the company repository. Provides quick access to common git commands scoped to the company root.

syntax

autopilot git log                          Show recent git commits (last 20)
autopilot git status                       Show working tree status
autopilot git push                         Push to origin main
autopilot git diff                         Show uncommitted changes

examples

# Check what's changed
autopilot git status

# Review uncommitted changes
autopilot git diff

# View recent commit history
autopilot git log

# Push changes to remote
autopilot git push

CLI Reference

On this page