All commands · context
pm aggregate
Group item counts and numeric measures.
Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.
Usage
pm aggregate [options]Options
| --set-mode <value> | Set grouping: element (default)|tuple | optional |
|---|---|---|
| --limit <value> | Group page size (default: 50) | optional |
| --after <value> | Continue with next_after cursor | optional |
| --group-by <value> | Fields: parent,type,priority,status,assignee,tags,sprint,release (comma-separated) | optional |
| --count | Counts (default) | optional |
| --completion | Status counts and completion_pct | optional |
| --sum <field> | Group numeric sum | optional |
| --avg <field> | Group numeric average | optional |
| --include-unparented | Keep unparented group | optional |
| --status <value> | Item status | optional |
| --type <value> | Item type | optional |
| --tag <value> | Filter by tag | optional |
| --priority <value> | Filter by priority | optional |
| --deadline-before <value> | Latest deadline (ISO/date or relative) | optional |
| --deadline-after <value> | Earliest deadline (ISO/date or relative) | optional |
| --assignee <value> | Filter by assignee | optional |
| --assignee-filter <value> | Assignee presence: assigned|unassigned | optional |
| --parent <value> | Parent ID | optional |
| --sprint <value> | Filter by sprint | optional |
| --release <value> | Filter by release | optional |
Examples
pm aggregate --group-by parent,type --count