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
| Subcommand | Alias | Description |
|---|---|---|
list | ls | List all tasks with filtering |
show <id> | get | Show detailed information for a task |
create <title> | - | Create a new task |
cancel <id> | - | Cancel a running or pending task |
retry <id> | - | Requeue a failed task |
status [id] | - | Quick status check or summary counts |
task list
Filter by task status:
pending, queued, in_progress, completed, failed, cancelled.Maximum number of tasks to return.
Output as JSON array.
task create <title>
Task title. The title is also used as the initial prompt if no description is provided.
Task description / detailed prompt for the agent.
Priority level from 1 (critical) to 5 (low). Affects queue ordering.
Agent name to assign the task to. Defaults to the system’s configured default agent.
Output created task as JSON.
task show <id>
Task ID or ID prefix (first 8 characters are sufficient).
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
| Status | Description |
|---|---|
pending | Waiting to be picked up by the queue |
queued | In the queue, waiting for an available agent |
in_progress | Currently being executed by an agent |
completed | Finished successfully |
failed | Execution ended with an error |
cancelled | Manually cancelled before completion |
Related
profclaw agent- View agent health and statsprofclaw queue- Inspect the task queueprofclaw summary- Browse completed work summariesprofclaw chat- Interactive agentic chat