# summary

List setup-agents tasks.

# description

Reads latest task state from `.setup-agents/state/tasks.jsonl`.

# flags.status.summary

Filter by task status.

# flags.status.description

Show only tasks with status `open`, `claimed`, or `done`.

# flags.role.summary

Filter by owning role.

# flags.role.description

Show only tasks owned by the given role, stored as a setup-agents profile owner.

# flags.profile.summary

Filter by owning setup-agents profile.

# flags.profile.description

Show only tasks owned by the given setup-agents profile.

# flags.mode.summary

Filter by workspace mode.

# flags.mode.description

Show only tasks recorded for project or advisory orchestration mode.

# flags.limit.summary

Maximum tasks to show.

# flags.limit.description

Limit the number of matching tasks returned from the end of the task list.

# examples

- List recent tasks:

  <%= config.bin %> <%= command.id %>

- List claimed tasks for a profile:

  <%= config.bin %> <%= command.id %> --status claimed --profile developer

- List advisory tasks:

  <%= config.bin %> <%= command.id %> --mode advisory

# info.empty

No task records found.