All commands · lifecycle
pm update many
Bulk-update matched items with dry-run plans and rollback checkpoints.
Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.
Usage
pm update many [options]Options
| --filter-status <value> | Filter by status before applying updates | optional |
|---|---|---|
| --filter-type <value> | Filter by item type before applying updates | optional |
| --filter-tag <value> | Filter by tag before applying updates | optional |
| --filter-priority <value> | Filter by priority before applying updates | optional |
| --filter-deadline-before <value> | Filter by deadline upper bound before applying updates | optional |
| --filter-deadline-after <value> | Filter by deadline lower bound before applying updates | optional |
| --filter-updated-after <value> | Filter by updated_at lower bound before applying updates (ISO/relative) | optional |
| --filter-updated-before <value> | Filter by updated_at upper bound before applying updates (ISO/relative) | optional |
| --filter-created-after <value> | Filter by created_at lower bound before applying updates (ISO/relative) | optional |
| --filter-created-before <value> | Filter by created_at upper bound before applying updates (ISO/relative) | optional |
| --filter-assignee <value> | Filter by assignee before applying updates | optional |
| --filter-assignee-filter <value> | Filter assignee presence: assigned|unassigned before applying updates | optional |
| --filter-parent <value> | Filter by parent item ID before applying updates | optional |
| --filter-sprint <value> | Filter by sprint before applying updates | optional |
| --filter-release <value> | Filter by release before applying updates | optional |
| --filter-ac-missing | Select only items missing acceptance_criteria (bulk backfill) | optional |
| --filter-estimates-missing | Select only items missing estimated_minutes (bulk backfill) | optional |
| --filter-resolution-missing | Select only terminal items missing resolution (bulk backfill) | optional |
| --filter-metadata-missing | Select only items missing any tracked metadata (AC, estimate, or resolution) | optional |
| --filter-has-notes | Select only items that have notes before applying updates | optional |
| --filter-no-notes | Select only items that have no notes before applying updates | optional |
| --filter-has-learnings | Select only items that have learnings before applying updates | optional |
| --filter-no-learnings | Select only items that have no learnings before applying updates | optional |
| --filter-has-files | Select only items that have linked files before applying updates | optional |
| --filter-no-files | Select only items that have no linked files before applying updates | optional |
| --filter-has-docs | Select only items that have linked docs before applying updates | optional |
| --filter-no-docs | Select only items that have no linked docs before applying updates | optional |
| --filter-has-tests | Select only items that have linked tests before applying updates | optional |
| --filter-no-tests | Select only items that have no linked tests before applying updates | optional |
| --filter-has-comments | Select only items that have comments before applying updates | optional |
| --filter-no-comments | Select only items that have no comments before applying updates | optional |
| --filter-has-deps | Select only items that have dependencies before applying updates | optional |
| --filter-no-deps | Select only items that have no dependencies before applying updates | optional |
| --filter-has-body | Select only items that have a non-empty body before applying updates | optional |
| --filter-empty-body | Select only items with an empty body before applying updates | optional |
| --filter-has-linked-command | Select only items whose linked tests carry a runnable command before applying updates | optional |
| --filter-no-linked-command | Select only items whose linked tests carry no runnable command before applying updates | optional |
| --filter-reviewer-missing | Select only items missing reviewer before applying updates | optional |
| --filter-risk-missing | Select only items missing risk before applying updates | optional |
| --filter-confidence-missing | Select only items missing confidence before applying updates | optional |
| --filter-sprint-missing | Select only items missing sprint before applying updates | optional |
| --filter-release-missing | Select only items missing release before applying updates | optional |
| --ids <value> | Explicit ID allowlist: comma/newline text, - stdin, or @path file | optional |
| --limit <n> | Limit matched item count before apply/preview | optional |
| --offset <n> | Skip first n matched rows before apply/preview | optional |
| --dry-run | Preview per-item diffs and checkpoint intent without mutating | optional |
| --rollback <value> | Rollback a prior update-many checkpoint ID | optional |
| --no-checkpoint | Disable checkpoint creation during apply mode | optional |
| --title, -t <value> | Set title | optional |
| --description, -d <value> | Set description | optional |
| --body, -b <value> | Set body (allow empty string) | optional |
| --status, -s <value> | Set status (use close command for closed) | optional |
| --priority, -p <value> | Set priority | optional |
| --type <value> | Set type | optional |
| --tags <value> | Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively. | optional |
| --add-tags <value> | Add tags additively without replacing existing (repeatable; CSV accepted) | optional |
| --remove-tags <value> | Remove tags from the existing list (repeatable; CSV accepted) | optional |
| --deadline <value> | Set deadline (ISO/date string or relative) | optional |
| --estimate, --estimated-minutes <value> | Set estimated minutes | optional |
| --acceptance-criteria <value> | Set acceptance criteria | optional |
| --add-ac <value> | Add one semicolon-free acceptance criterion without replacing the existing list (repeatable) | optional |
| --remove-ac <value> | Remove one semicolon-free acceptance criterion by exact text match (repeatable) | optional |
| --definition-of-ready <value> | Set definition of ready | optional |
| --order <value> | Set planning order/rank integer | optional |
| --goal <value> | Set goal identifier | optional |
| --objective <value> | Set objective identifier | optional |
| --value <value> | Set business value summary | optional |
| --impact <value> | Set business impact summary | optional |
| --outcome <value> | Set expected outcome summary | optional |
| --why-now <value> | Set why-now rationale | optional |
| --assignee <value> | Set assignee | optional |
| --parent <value> | Set parent item ID | optional |
| --reviewer <value> | Set reviewer | optional |
| --risk <value> | Set risk level | optional |
| --confidence <value> | Set confidence level | optional |
| --sprint <value> | Set sprint identifier | optional |
| --release <value> | Set release identifier | optional |
| --blocked-by <value> | Set blocked-by item ID or reason | optional |
| --blocked-reason <value> | Set blocked reason | optional |
| --unblock-note <value> | Set unblock rationale note | optional |
| --reporter <value> | Set issue reporter | optional |
| --severity <value> | Set issue severity | optional |
| --environment <value> | Set issue environment context | optional |
| --repro-steps <value> | Set issue reproduction steps | optional |
| --resolution <value> | Set issue resolution summary | optional |
| --expected-result <value> | Set issue expected behavior | optional |
| --expected <value> | Short alias for --expected-result | optional |
| --actual-result <value> | Set issue observed behavior | optional |
| --actual <value> | Short alias for --actual-result | optional |
| --affected-version <value> | Set affected version identifier | optional |
| --fixed-version <value> | Set fixed version identifier | optional |
| --component <value> | Set issue component ownership | optional |
| --regression [value] | Set regression marker; bare flag means true, or pass true|false|1|0 | optional |
| --customer-impact <value> | Set customer impact summary | optional |
| --dep <value> | Add dependency entry id=<id>,kind=<kind>,author=<author>,created_at=<timestamp> | optional |
| --dep-remove <value> | Remove dependency entries by id/kind/author/timestamp signature | optional |
| --replace-deps | Atomically replace dependency entries with provided --dep values | optional |
| --replace-tests | Atomically replace linked tests with provided --test values | optional |
| --replace-files | Atomically replace linked files with provided --file values | optional |
| --replace-docs | Atomically replace linked docs with provided --doc values | optional |
| --comment <value> | Add comment seed author=<value>,created_at=<iso|now>,text=<value> | optional |
| --note <value> | Add note seed author=<value>,created_at=<iso|now>,text=<value> | optional |
| --learning <value> | Add learning seed author=<value>,created_at=<iso|now>,text=<value> | optional |
| --file <value> | Add linked file path=<value>,scope=<project|global>,note=<text> | optional |
| --test <value> | Add linked test command=<value>,path=<value>,scope=<project|global> | optional |
| --doc <value> | Add linked doc path=<value>,scope=<project|global>,note=<text> | optional |
| --reminder <value> | Add reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text> | optional |
| --event <value> | Add event entry start=<iso|relative>,end=<iso|relative>,recur_* | optional |
| --type-option <value> | Set type options key=value (repeatable) | optional |
| --unset <field> | Clear scalar metadata field by name (repeatable) | optional |
| --clear-deps | Clear dependency entries | optional |
| --clear-comments | Clear comments | optional |
| --clear-notes | Clear notes | optional |
| --clear-learnings | Clear learnings | optional |
| --clear-files | Clear linked files | optional |
| --clear-tests | Clear linked tests | optional |
| --clear-docs | Clear linked docs | optional |
| --clear-reminders | Clear reminders | optional |
| --clear-events | Clear events | optional |
| --clear-type-options | Clear type options | optional |
| --author <value> | Mutation author | optional |
| --message <value> | Mutation message | optional |
| --force | Force ownership override | optional |
Examples
pm update many --filter-status open --status in_progress --dry-run