Skip to content
Core ConceptsCLI ReferenceAPI Reference
Task
AGH RuntimeTask

agh task list

List tasks

Audience
Operators running durable agent work
Focus
Task guidance shaped for scanability, day-two clarity, and operator context.

agh task list

List tasks

agh task list [flags]

Options

      --channel string      Filter by network channel
  -h, --help                help for list
      --last int            Show only the most recent N tasks
      --owner-kind string   Filter by owner kind
      --owner-ref string    Filter by owner reference
      --parent string       Filter by parent task ID
      --scope string        Filter by scope: global or workspace
      --status string       Filter by task status
      --workspace string    Filter by workspace path, name, or ID

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every AGH command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Example:

agh task list -o json

agh task heartbeat

Extend a claimed task run lease for the current agent session

agh task next

Claim the next task run for the current agent session

On this page

agh task listOptionsOptions inherited from parent commandsOutput Formats