Skip to content
Task
CompozyOS RuntimeTask

compozy task list

List tasks

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

compozy task list

List tasks

compozy task list [flags]

Options

      --cursor string                  Continue from an opaque catalog cursor
  -h, --help                           help for list
      --limit int                      Maximum tasks to return (1-200)
      --owner-kind string              Filter by owner kind
      --owner-ref string               Filter by owner reference
      --parent string                  Filter by parent task ID
      --participation-channel string   Filter by resolved participation channel
      --priority string                Filter by task priority
      --query string                   Search task title or identifier
      --scope string                   Filter by scope: global or workspace
      --sort string                    Sort by recent or priority (default "recent")
      --status string                  Filter by task status
      --workspace string               Override workspace filter (ID, name, or path)

Options inherited from parent commands

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

Output Formats

Every Compozy 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:

compozy task list -o json

On this page