CLI Reference

Complete reference for every powerglide command, subcommand, and flag. For conceptual explanations of what these do and why, see the Features and Architecture pages.

Main Command

powerglide — the CLI coding agent that slides

USAGE:
    powerglide [command] [options] [args...]

COMMANDS:
    run         Launch an agent coding session
    session     Manage agent sessions (list, show, resume, delete, export)
    agent       Manage agent configurations (list, add, remove, show)
    swarm       Manage agent swarms (list, create, add, remove, run, status, stop)
    config      Manage powerglide configuration (show, set, get, reset, edit)
    tools       List and test available tools (list, show, test)
    tui         Open the interactive multi-agent dashboard
    doctor      Run system health checks
    version     Show version information

Run 'powerglide [command] --help' for command-specific help.

powerglide run

Launch an agent coding session. The agent runs the Ralph Loop until all tasks are complete, the step limit is hit, or an unrecoverable error occurs.

USAGE:
    powerglide run [options] [message]

OPTIONS:
    --agent, -a <name>      Agent configuration to use (default: hephaestus)
    --velocity, -v <mult>   Velocity multiplier — delay = 1000ms / velocity (default: 1.0)
    --session-id, -s <id>   Resume or create a named session for recovery
    --model, -m <model>     Override the configured model (e.g. claude-opus-4-6)
    --help, -h              Show this help

Examples

# Basic session
powerglide run "refactor this function to be more idiomatic Zig"

# Use a specific agent configuration
powerglide run --agent hephaestus "add unit tests for the auth module"

# Fast mode — 500ms between steps (velocity=2.0 → 1000ms/2.0)
powerglide run --velocity 2.0 "quick fix"

# Slow mode — 2000ms between steps, easier to monitor manually
powerglide run --velocity 0.5 "refactor with careful review"

# Named session — can be resumed after a crash or interruption
powerglide run --session-id feature-auth "implement OAuth2 flow"
powerglide run --session-id feature-auth "continue"

powerglide session

Manage agent sessions.

USAGE:
    powerglide session [subcommand] [options]

SUBCOMMANDS:
    list        List all sessions
    show        Show session details
    resume      Resume a session
    delete      Delete a session
    export      Export session to file

Examples

# List sessions
powerglide session list

# Show session
powerglide session show abc123

# Resume session
powerglide session resume abc123

# Delete session
powerglide session delete abc123

# Export session
powerglide session export abc123 > session.json

powerglide agent

Manage agent configurations.

USAGE:
    powerglide agent [subcommand] [options]

SUBCOMMANDS:
    list        List all agents
    add         Add a new agent
    remove      Remove an agent
    show        Show agent details

Examples

# List agents
powerglide agent list

# Add agent
powerglide agent add my-agent --model "claude-sonnet-4"

# Show agent
powerglide agent show my-agent

# Remove agent
powerglide agent remove my-agent

powerglide swarm

Manage agent swarms.

USAGE:
    powerglide swarm [subcommand] [options]

SUBCOMMANDS:
    list        List all swarms
    create      Create a new swarm
    add         Add agent to swarm
    remove      Remove agent from swarm
    run         Run a swarm task
    status      Show swarm status
    stop        Stop a running swarm

Examples

# Create swarm
powerglide swarm create my-team --agents 3

# Add agent to swarm
powerglide swarm add my-team --agent hephaestus

# Run swarm task
powerglide swarm run my-team "implement authentication"

# Check status
powerglide swarm status my-team

# Stop swarm
powerglide swarm stop my-team

powerglide config

Manage powerglide configuration.

USAGE:
    powerglide config [subcommand] [options]

SUBCOMMANDS:
    show        Show current configuration
    set         Set a configuration value
    get         Get a configuration value
    reset       Reset configuration to defaults
    edit        Edit configuration file

Examples

# Show config
powerglide config show

# Set value
powerglide config set default_agent hephaestus

# Get value
powerglide config get default_agent

# Reset to defaults
powerglide config reset

# Edit config file
powerglide config edit

powerglide tools

List and test available tools.

USAGE:
    powerglide tools [subcommand] [options]

SUBCOMMANDS:
    list        List all tools
    show        Show tool details
    test        Test a tool

Examples

# List tools
powerglide tools list

# Show tool
powerglide tools show bash

# Test tool
powerglide tools test bash --args "echo hello"

powerglide tui

Open the interactive multi-agent dashboard.

USAGE:
    powerglide tui [options]

OPTIONS:
    --refresh, -r <ms>    Refresh rate in ms (default: 1000)
    --help, -h            Show this help

powerglide doctor

Run system health checks before starting a session. Surfaces configuration and dependency issues before any tokens are spent.

USAGE:
    powerglide doctor

Checks:
    - zig              Version and PATH availability
    - oh-my-opencode   npx availability for omo-style agents
    - git              Version (required for commit-phase operations)
    - API keys         ANTHROPIC_API_KEY, OPENAI_API_KEY presence in environment
    - Config dir       ~/.config/powerglide/ structure and permissions

Example Output

$ powerglide doctor
✓ zig 0.15.2 found at /usr/local/bin/zig
✓ oh-my-opencode found
✓ git 2.40.1 found
✓ ANTHROPIC_API_KEY set
✗ OPENAI_API_KEY not set
✓ Config directory exists

powerglide version

Show version information.

USAGE:
    powerglide version

Output:
    powerglide 0.1.0
    Zig 0.15.2
    Target: x86_64-linux

Environment Variables

Back to Home · Features · Configuration