RED STATION

Appearance

CLI Reference ​

The pilot command line interface is your primary control surface for the Red Station platform.

Global Options ​

bash
pilot [OPTIONS] COMMAND [ARGS]
  • --help: Show help message.
  • --version: Show version.
  • --json: Output command results as JSON where applicable.

Core System ​

pilot init ​

Initialize the Pilot environment. Running without flags starts Interactive Mode (Wizard).

  • --global, -g: Initialize the global ~/.pilot/ registry and configuration.
  • --project, -p: Initialize the local project .pilot/ configuration.
  • --force, -f: Overwrite existing configuration.

Interactive Setup: During global initialization, an interactive wizard will guide you through:

  1. Theme Selection:

    • Mars Mission Control: The default, immersive experience with color-coded panels and modern styling.
    • Classic: A minimal, terminal-standard view for high-contrast accessibility or legacy terminals.

  2. Default Configurations:

    • Yes (Recommended): Installs the standard library of Agents (coder, planner), Workflows (ticket-to-pr), and Policies. Best for getting started.
    • No (Minimal): Creates empty directories. Use this if you want a completely clean slate to build your own custom environment from scratch.

pilot status ​

Check the health of system components.

  • pilot status engine: Control Plane Engine status.
  • pilot status agents: Agent Runtime status.
  • pilot status mcp: MCP connection status.
  • --json: Output as JSON.

pilot config ​

Manage configuration values.

  • pilot config show: Display current configuration.
  • pilot config edit: Open config file in default editor.
  • pilot config theme: Interactive theme switcher (Mission Control / Classic).

Task Management ​

pilot task run ​

Execute a task with the specified autonomy level.

bash
pilot task run [OPTIONS] TASK_ID
  • --autonomy, -a: Set autonomy level (suggest, auto).
  • --dry-run: Simulate execution.

pilot task import ​

Import a task from an external system.

  • --source, -s: Source system (default: manual).
  • --title, --description: Metadata for manual import.

Interactive Mode: When importing manually without metadata, an interactive wizard will launch to guide you.

pilot task plan ​

Generate an implementation plan without executing it.

bash
pilot task plan TASK_ID
  • --model: Override model for planning.
  • --skip-approval: Skip plan approval.

pilot task list ​

List active tasks.

  • --status, -s: Filter by status (pending, running, completed).
  • --limit, -n: Max tasks to show (default: 20).

Agent Management ​

pilot agent list ​

List all registered agents.

  • --verbose, -v: Show extended details (autonomy, source).
  • --builtin: Show only built-in agents.
  • --custom: Show only custom agents.

pilot agent run ​

Ad-hoc agent execution.

bash
pilot agent run AGENT_ID [OPTIONS]
  • --task, -t: Task instruction (required).
  • --json: Output as JSON.
  • --verbose, -v: Show detailed output.

pilot agent create ​

Scaffold a new custom agent.

bash
pilot agent create AGENT_ID [OPTIONS]
  • --name, -n: Display name for the agent.
  • --category, -c: Category (default: general).

Workflow Management ​

pilot workflow list ​

List available workflows.

  • --builtin, -b: Show only built-in workflows.
  • --custom, -c: Show only custom workflows.
  • --verbose, -v: Show more details.

pilot workflow run ​

Manually trigger a workflow.

bash
pilot workflow run WORKFLOW_ID [OPTIONS]
  • --task, -t: Attach to a specific task ID context.
  • --dry-run, -d: Show steps without executing.
  • --non-interactive, -n: Disable interactive output (CI/CD mode).

Interactive Mode: By default, workflows run interactively with real-time feedback. Use -n for silent execution.

The Matrix (MCP) ​

pilot mcp servers ​

List connected Model Context Protocol servers.

pilot mcp tools ​

List all tools available to agents.

  • --server, -s: Filter list by server name (e.g., filesystem).

pilot mcp call ​

Execute a tool directly (useful for debugging).

bash
pilot mcp call SERVER TOOL [OPTIONS]
  • --args, -a: JSON arguments string (e.g., '{"path": "."}').
  • --json: Output result as JSON.

Governance ​

pilot policy list ​

Show active policies.

pilot policy test ​

Test policy evaluation against a context.

  • --file: File path to test against.
  • --action: Action to test.

Secrets Management ​

pilot secrets ​

Manage secure credentials.

  • pilot secrets list: List stored secret keys.
    • --show, -s: Show actual values (careful!).
  • pilot secrets set: Set a secret value.
    • --value, -v: Provide value inline (avoids prompt).
  • pilot secrets delete: Delete a secret.
    • --force, -f: Skip confirmation.
  • pilot secrets import-env: Import from environment.
    • --prefix, -p: Var prefix to look for (default: PILOT_SECRET_).

Audit ​

pilot audit list ​

List recent audit events.

  • --limit, -n: Number of events to show.
  • --json: Output as JSON.

Released under the MIT License.

Copyright © 2026 Red Station