aq-taskslisted
Install: claude install-skill ElectricJack/agent-queue
# aq tasks — Working with tasks from the CLI
Every task operation runs through `aq task <subcommand>`. Run
`aq task --help` for the current subcommand list; `aq task <cmd> --help`
for arguments.
## Read paths (safe, no side effects)
Available to any caller, including a non-elevated worker or reviewer session:
```bash
aq task show <task_id> # full detail for one task
aq task comments <task_id> # durable comment history, newest first
aq task children --task-id <id> [--recursive] [--status S] [--limit N] [--offset N]
# direct or recursive children of a container
aq task progress --task-id <id> # computed group progress: counts, waves,
# max parallelism — never stored, always
# derived from the current graph
```
Operator reads — a local CLI caller or an elevated (supervisor / triage)
session. A plain worker or reviewer token gets `out of scope: <command>`,
so do not build a workflow on them:
```bash
aq task list # active tasks, current project scope
aq task list --status IN_PROGRESS # filter by status
aq task list --json --brief # scriptable projection. --json and
# --brief are global: before the group,
# after the command, either works.
aq task get --task-id <task_id> # single-row summary
aq task deps --task-id <task_id> # depende