compozy task next

compozy task next [flags]

  # Claim the next available run for this session
  compozy task next

  # Wait until matching work is claimable and request a five-minute lease
  compozy task next --wait --lease-seconds 300 -o json

  # Claim one exact queued run through the canonical lease path
  compozy task next --run-id run-123 -o json

  # Filter by required caller capability
  compozy task next --capability go.test --priority-min 10

      --capability stringArray   Caller capability filter (repeatable)
  -h, --help                     help for next
      --idempotency-key string   Optional idempotency key
      --lease-seconds int        Lease duration in seconds
      --priority-min int         Minimum task priority
      --run-id string            Claim exactly this queued run
      --wait                     Wait until work is claimable
      --workspace string         Override workspace binding (ID, name, or path)

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

compozy task next -o json