Pilot UI

The Pilot UI is a local web dashboard that provides a visual interface for managing your agents, tasks, and workflows.

While the CLI is perfect for quick interactions and scripting, the UI offers a rich environment for:

• Visualizing Traces: Watching agent thought processes in real-time.
• Task Management: Drag-and-drop boards (Kanban) for task lifecycles.
• Trace History: deep-diving into past execution logs.

Launching

To start the dashboard, simply run:

pilot ui

This command:

1. Starts a local API Server (default: port 8000).
2. Starts the Web Interface (default: port 5173).
3. Automatically opens your default browser.

Context Modes

The UI adapts based on where you launch it:

1. Project Mode

If you run pilot ui inside a repository initialized with pilot init --project (containing a .pilot folder):

• Scope: The UI focuses only on that specific project.
• Data: Loads tasks, agents, and workflows defined in the project's .pilot directory.
• Use Case: Deep work on a single repository.

2. Global Mode

If you run pilot ui from your home directory or any non-project location:

• Scope: System-wide operations.
• Data: Loads from your global ~/.pilot/ registry.
• Use Case: Managing global agents, reviewing cross-project history, or configuring system-wide settings.

Command Options

# Custom ports
pilot ui --port 8080 --ui-port 3000

# Start backend only (useful if you want to run the UI from source separately)
pilot ui --api-only

# Start without opening the browser automatically
pilot ui --no-browser

Architecture

The UI is a Local-First application.

• No Cloud Sync: All data is read directly from your local SQLite database and YAML files.
• Direct Control: Actions in the UI (like "Run Task") map directly to CLI executions on your machine.