# summary

List setup-agents handoff records.

# description

Reads JSON Lines handoff entries from `.setup-agents/state/handoffs.jsonl`.

# flags.task.summary

Filter by task or issue id.

# flags.task.description

Show only handoff records associated with the given task id.

# flags.role.summary

Filter by owning role.

# flags.role.description

Show only handoff records owned by the given role.

# flags.profile.summary

Filter by owning setup-agents profile.

# flags.profile.description

Show only handoff records owned by the given setup-agents profile.

# flags.from.summary

Filter by source role or profile.

# flags.from.description

Show only handoffs from the given role or profile.

# flags.to.summary

Filter by target role or profile.

# flags.to.description

Show only handoffs to the given role or profile.

# flags.limit.summary

Maximum records to show.

# flags.limit.description

Limit the number of matching records returned from the end of the handoff log.

# examples

- List recent handoffs:

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

- List handoffs for a task:

  <%= config.bin %> <%= command.id %> --task SA-96

# info.empty

No handoff records found.

# info.truncated

Showing last entries (%s total). Full log: %s

# warn.invalidLine

Skipping invalid handoff JSONL line: %s