All commands · lifecycle
pm claim
Claim an item for active work.
Claims an item to signal active ownership and reduce conflicts.
Usage
pm claim [options] [id]Arguments
| <id> | Item id (omit with --next) | optional |
|---|
Options
| --start | Claim and start an explicit item | optional |
|---|---|---|
| --author <value> | Mutation author | optional |
| --message <value> | History message | optional |
| --force | Force claim override | optional |
| --if-available | Skip another author's claim (skipped=true) | optional |
| --next | Atomically claim the next caller-available actionable item | optional |
| --type <value> | Filter --next candidates by type | optional |
| --tag <value> | Filter --next candidates by tag | optional |
| --priority <value> | Filter --next candidates by priority | optional |
| --assignee-filter <value> | Filter --next candidates: assigned|unassigned | optional |
| --parent <id> | Scope --next candidates to a subtree | optional |
| --sprint <value> | Filter --next candidates by sprint | optional |
| --release <value> | Filter --next candidates by release | optional |
| --max-attempts <n> | Bound the --next candidate walk (default 10; maximum 100) | optional |
| --include-decisions | Allow --next to claim human-gated Decision items | optional |
| --include-gates | Allow --next to claim outcome gates | optional |
| --include-containers | Allow --next to claim containers with unfinished descendants | optional |
| --token-budget <n> | Bound the estimated tokens used to rank --next candidates | optional |
| --explain-ranking | Include ranking provenance for --next selection | optional |
Examples
pm claim pm-a1b2 --start