Genesis Docs

Inspect durable background tasks and Task Flow state. With no subcommand, genesis tasks is equivalent to genesis tasks list.

See Background Tasks for the lifecycle and delivery model.

Usage

genesis tasks
genesis tasks list
genesis tasks list --runtime acp
genesis tasks list --status running
genesis tasks show <lookup>
genesis tasks notify <lookup> state_changes
genesis tasks cancel <lookup>
genesis tasks audit
genesis tasks maintenance
genesis tasks maintenance --apply
genesis tasks flow list
genesis tasks flow show <lookup>
genesis 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

genesis tasks list [--runtime <name>] [--status <name>] [--json]

Lists tracked background tasks newest first.

show

genesis tasks show <lookup> [--json]

Shows one task by task ID, run ID, or session key.

notify

genesis tasks notify <lookup> <done_only|state_changes|silent>

Changes the notification policy for a running task.

cancel

genesis tasks cancel <lookup>

Cancels a running background task.

audit

genesis tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records.

maintenance

genesis tasks maintenance [--apply] [--json]

Previews or applies task and Task Flow reconciliation, cleanup stamping, and pruning.

flow

genesis tasks flow list [--status <name>] [--json]
genesis tasks flow show <lookup> [--json]
genesis tasks flow cancel <lookup>

Inspects or cancels durable Task Flow state under the task ledger.

Related