Skip to main content
Inspect durable background tasks and Task Flow state. With no subcommand, fluffbuzz tasks is equivalent to fluffbuzz tasks list. See Background Tasks for the lifecycle and delivery model.

​
Usage

fluffbuzz tasks
fluffbuzz tasks list
fluffbuzz tasks list --runtime acp
fluffbuzz tasks list --status running
fluffbuzz tasks show <lookup>
fluffbuzz tasks notify <lookup> state_changes
fluffbuzz tasks cancel <lookup>
fluffbuzz tasks audit
fluffbuzz tasks maintenance
fluffbuzz tasks maintenance --apply
fluffbuzz tasks flow list
fluffbuzz tasks flow show <lookup>
fluffbuzz tasks flow cancel <lookup>

​
Root Options

  • --json: output JSON.
  • --runtime <name>: filter by kind: subagent, acp, cron, or cli.
  • --status <name>: filter by status: queued, running, succeeded, failed, timed_out, cancelled, or lost.

​
Subcommands

​
list

fluffbuzz tasks list [--runtime <name>] [--status <name>] [--json]
Lists tracked background tasks newest first.

​
show

fluffbuzz tasks show <lookup> [--json]
Shows one task by task ID, run ID, or session key.

​
notify

fluffbuzz tasks notify <lookup> <done_only|state_changes|silent>
Changes the notification policy for a running task.

​
cancel

fluffbuzz tasks cancel <lookup>
Cancels a running background task.

​
audit

fluffbuzz tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]
Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records.

​
maintenance

fluffbuzz tasks maintenance [--apply] [--json]
Previews or applies task and Task Flow reconciliation, cleanup stamping, and pruning.

​
flow

fluffbuzz tasks flow list [--status <name>] [--json]
fluffbuzz tasks flow show <lookup> [--json]
fluffbuzz tasks flow cancel <lookup>
Inspects or cancels durable Task Flow state under the task ledger.