shc task
inspect background tasks and workers
Reference for the task CLI group. Source: modules/task/commands/.
Subcommands
Section titled “Subcommands”| Subcommand | Description |
|---|---|
ls | list tasks (running and pending by default; -a for any status) |
show | show a single task’s full state |
cancel | cancel a PENDING task |
workers | list queue workers |
shc task ls
Section titled “shc task ls”list tasks (running and pending by default; -a for any status)
Alias: list. --dead overrides --status/--all (dead tasks are FAILED/TIMED_OUT with retries exhausted).
| Flag | Type | Required | Help |
|---|---|---|---|
-S / --status | str | no | comma-separated status filter |
-a / --all | bool | no | show all tasks |
--dead | bool | no | only tasks that exhausted retries |
--node | str | no | only tasks claimed on this node |
-n / --limit | str | no | number of entries to show |
Source: modules/task/commands/
shc task show
Section titled “shc task show”show a single task’s full state
Accepts a full task id or the unique 8-char prefix task ls prints.
Source: modules/task/commands/
shc task cancel
Section titled “shc task cancel”cancel a PENDING task
Destructive — prompts; --yes skips. Accepts a full task id or the unique 8-char prefix task ls prints.
| Flag | Type | Required | Help |
|---|---|---|---|
-r / --reason | str | no | reason recorded in the task’s error column |
-y / --yes | bool | no | skip confirmation prompt |
Source: modules/task/commands/
shc task workers
Section titled “shc task workers”list queue workers
No declared flags.
Source: modules/task/commands/
shc@docs:~$