# summary

Claim a setup-agents task.

# description

Appends a claimed task state entry to `.setup-agents/state/tasks.jsonl`.

# flags.task.summary

Task id.

# flags.task.description

Task id to claim.

# flags.role.summary

Claiming role.

# flags.role.description

Alias for a setup-agents profile owner such as `developer`, stored as `setup-agents:developer`.

# flags.profile.summary

Claiming setup-agents profile.

# flags.profile.description

Record the setup-agents profile claiming this task.

# flags.evidence.summary

Related evidence ids.

# flags.evidence.description

Comma-separated evidence record ids to attach while claiming.

# examples

- Claim a task as the developer profile:

  <%= config.bin %> <%= command.id %> --task SA-97 --profile developer

# info.claimed

Task claimed: %s by %s (%s)

# errors.notFound

Task not found: %s