prlt work
The work command group handles everything related to assigning tickets to agents and managing the execution lifecycle.
Subcommands
| Command | Description |
|---|---|
work start | Start work on a single ticket with one agent |
work spawn | Batch-spawn agents for multiple tickets |
work spawn-all | Spawn all tickets in a column |
work watch | Auto-spawn agents as tickets enter a column |
work status | View all in-progress work |
work ready | Mark work as ready for review (optionally create PR) |
work complete | Mark work as fully complete |
work review | Run the review pipeline on a ticket |
work revise | Re-spawn agent to address review feedback |
work resolve | Resolve questions raised by agents |
work linear | Start work from a Linear issue |
work jira | Start work from a Jira issue |
work source | Configure default work source |
work start
Start work on a single ticket. Assigns an agent, creates a branch, and launches a tmux session.
$ prlt work start <ticket-id> [flags]
| Flag | Description |
|---|---|
--agent | Assign a specific agent (otherwise auto-assigned) |
--action | Action type: implement, review, test, refactor, groom |
--message | Custom prompt message appended to the ticket |
--environment | Execution environment: host, docker, devcontainer |
--display | Display mode: terminal, background |
--skip-permissions | Skip permission prompts (full autonomy) |
# Basic start
$ prlt work start TKT-001
# Start with specific options
$ prlt work start TKT-001 \
--agent bezos \
--action implement \
--environment docker \
--display backgroundwork spawn
Batch-spawn agents for multiple tickets. Supports several selection modes.
$ prlt work spawn [ticket-ids...] [flags]
| Flag | Description |
|---|---|
--all | Spawn all tickets in the selected column |
--many | Multi-select mode for choosing tickets |
--column | Filter by board column |
--count | Limit number of tickets to spawn |
--diet | Use diet-balanced selection |
--category | Filter by ticket category |
--priority | Filter by priority level |
--action | Action type for all spawned tickets |
--message | Custom prompt message for all tickets |
--from-linear | Pull and spawn from Linear issues |
--dry-run | Preview what would be spawned |
# Spawn all ready tickets $ prlt work spawn --column "Ready" --all # Spawn top 5 with diet balancing $ prlt work spawn --diet --count 5 # Dry run to preview $ prlt work spawn --column "Ready" --all --dry-run
work ready
Mark work as ready for review. Optionally creates a GitHub PR.
# Create a PR when marking ready $ prlt work ready TKT-001 --pr # Mark ready without a PR $ prlt work ready TKT-001 --no-pr
work review
Run the automated review pipeline: a reviewer agent reads the diff and provides feedback.
$ prlt work review TKT-001
Note
The review pipeline cycles through review → fix → re-review until the reviewer approves or the maximum iteration count is reached.