CLI Reference
The prlt command is the primary interface for Proletariat. Every operation — from creating tickets to spawning agents to monitoring boards — is a CLI command.
Command Groups
| Command | Description |
|---|---|
prlt init | Initialize a new headquarters (HQ) |
prlt work | Start, spawn, review, and manage agent work |
prlt ticket | Create, edit, list, and manage tickets |
prlt board | View and manage the kanban board |
prlt agent | Manage agents — list, add staff, cleanup |
prlt session | Manage tmux sessions — attach, peek, poke |
prlt repo | Add, remove, and list repositories |
Click any command group above for detailed flag and subcommand documentation.
Utility Commands
| Command | Description |
|---|---|
prlt whoami | Show current agent identity and context |
prlt commit | Create a formatted git commit with ticket context |
prlt pull | Pull tickets from Backlog to Ready using diet ratios |
prlt diet | View or set diet ratios for balanced work distribution |
prlt project | Manage projects (create, list, view, archive) |
prlt epic | Manage epics (create, list, view, progress) |
prlt spec | Manage specs (create, edit, plan) |
prlt orchestrator | Start, stop, and monitor the orchestrator |
prlt docker | Manage Docker containers for agents |
prlt gh | GitHub CLI setup and status |
prlt linear | Linear integration (auth, sync, import) |
prlt config | View and update workspace configuration |
prlt caffeinate | Keep macOS awake while agents run |
Global Flags
| Flag | Description |
|---|---|
--json | Machine-readable JSON output for agent consumption |
--machine | Alias for --json |
--project, -P | Scope command to a specific project |
Note
All commands support --json for structured output. See JSON Mode for details.
Getting Help
# Show help for any command $ prlt --help $ prlt work --help $ prlt ticket create --help # Show current identity $ prlt whoami