Synopsis
Description
queue provides visibility into profClaw’s task execution queue. In mini mode, an in-memory queue is used. In pro mode, BullMQ with Redis is used for durability and distributed processing. Queue commands let you see what is waiting, pause processing, drain failed jobs, and check queue health metrics.
Subcommands
| Subcommand | Description |
|---|---|
status | Show queue health, counts by state, and throughput metrics |
list [state] | List jobs in a specific state |
drain | Remove all completed and failed jobs |
pause | Pause job processing |
resume | Resume paused job processing |
retry-all | Requeue all failed jobs |
queue status
Shows queue state counts (waiting, active, completed, failed, delayed), current workers, and throughput.
Output as JSON.
queue list [state]
Job state to list:
waiting, active, completed, failed, delayed.Maximum jobs to show.
Output as JSON.
queue drain
Removes stale completed and failed jobs to free memory (in-memory mode) or Redis storage (pro mode).
Only remove failed jobs.
Only remove completed jobs.
Examples
Queue Modes
| Mode | Backend | Persistence | Workers |
|---|---|---|---|
pico / mini | In-memory | None (lost on restart) | Single process |
pro | BullMQ + Redis | Durable | Multiple workers |
Related
profclaw task- View and manage individual tasksprofclaw status- System overview- Deployment Modes - Queue configuration per mode