Synopsis
Description
task manages the agentic work queue. Tasks are units of work assigned to agents - they can originate from GitHub issues, Jira tickets, Linear cards, Slack messages, cron schedules, or the CLI. Each task progresses through a lifecycle: pending -> queued -> in_progress -> completed (or failed / cancelled).
Subcommands
task list
string
Filter by task status:
pending, queued, in_progress, completed, failed, cancelled.string
default:"20"
Maximum number of tasks to return.
boolean
Output as JSON array.
task create <title>
string
required
Task title. The title is also used as the initial prompt if no description is provided.
string
Task description / detailed prompt for the agent.
string
default:"3"
Priority level from 1 (critical) to 5 (low). Affects queue ordering.
string
Agent name to assign the task to. Defaults to the system’s configured default agent.
boolean
Output created task as JSON.
task show <id>
string
required
Task ID or ID prefix (first 8 characters are sufficient).
boolean
Output as JSON.
task status [id]
Without an ID, prints a summary count by status. With an ID, prints just the status string for that task - useful in scripts.
Examples
Task Status Values
Related
profclaw agent- View agent health and statsprofclaw queue- Inspect the task queueprofclaw summary- Browse completed work summariesprofclaw chat- Interactive agentic chat