All commands · context
pm list
List active items with optional lifecycle-status and project filters.
Lists active items with deterministic filtering and ordering.
Usage
pm list [options]Options
| --status <value> | Filter by status (repeatable or comma-separated; matches any; all selects every status) | optional |
|---|---|---|
| --all | Include every lifecycle status | optional |
| --for <intent> | Apply a declared context intent projection. Allowed core values: triage. Configured package and workspace intents may extend this domain. | optional |
| --token-budget <n> | Override the selected intent's maximum estimated output tokens | optional |
| --type <value> | Filter by item type (repeatable or comma-separated; matches any) | optional |
| --tag <value> | Filter by tag (repeatable or comma-separated; matches any) | optional |
| --priority <value> | Filter by priority (repeatable or comma-separated; matches any) | optional |
| --deadline-before <value> | Filter by deadline upper bound (ISO/date string or relative) | optional |
| --deadline-after <value> | Filter by deadline lower bound (ISO/date string or relative) | optional |
| --today | Filter to items updated since local midnight today | optional |
| --recent | Filter to items updated in the last 7 days | optional |
| --updated-after <value> | Updated since ISO timestamp or signed relative (-2h/-7d for past); use last-window ISO | optional |
| --updated-before <value> | Filter by updated_at upper bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --created-after <value> | Filter by created_at lower bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --created-before <value> | Filter by created_at upper bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --ids <value> | Filter by explicit item IDs (comma-separated or repeatable) | optional |
| --assignee <value> | Filter by assignee | optional |
| --assignee-filter <value> | Filter assignee presence: assigned|unassigned | optional |
| --parent <value> | Filter by parent item ID | optional |
| --sprint <value> | Filter by sprint | optional |
| --release <value> | Filter by release | optional |
| --filter-ac-missing | Show only items missing acceptance_criteria | optional |
| --filter-estimates-missing | Show only items missing estimated_minutes | optional |
| --filter-resolution-missing | Show only terminal items missing resolution | optional |
| --filter-metadata-missing | Show only items missing any tracked metadata (AC, estimate, or resolution) | optional |
| --offset <n> | Skip the first n matching rows before limit is applied | optional |
| --after <cursor> | Continue after an opaque next_cursor from a previous list response | optional |
| --no-truncate | Return every matched row after the explicit status and field filters | optional |
| --include-body | Include item body in each returned list row | optional |
| --strict-read | Fail closed if any item document or item directory cannot be read | optional |
| --compact | Render compact list projection fields (mutually exclusive with --brief/--full/--fields) | optional |
| --brief | Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--full/--fields) | optional |
| --full | Render full list projection fields (mutually exclusive with --compact/--brief/--fields) | optional |
| --fields <value> | Render custom comma-separated list fields (mutually exclusive with --compact/--brief/--full). Allowed core values: acceptance_criteria|actual_result|affected_version|assignee|author|blocked_by|blocked_reason|body|claim_principal|close_reason|closed_at|comments|completed_at|component|confidence|created_at|customer_impact|deadline|definition_of_ready|dependencies|description|design|docs|duplicate_of|environment|estimated_minutes|events|expected_result|external_ref|files|fixed_version|goal|id|impact|learnings|notes|objective|order|outcome|parent|plan_decisions|plan_discoveries|plan_harness|plan_mode|plan_resume_context|plan_scope|plan_steps|plan_validation|pm_format_version|priority|regression|release|reminders|reporter|repro_steps|resolution|reviewer|risk|severity|source_owner|source_type|sprint|status|tags|test_runs|tests|title|tree_children|tree_depth|tree_parent|tree_title|type|type_options|unblock_note|updated_at|value|why_now. item.<field> aliases and configured runtime metadata fields are also accepted. | optional |
| --sort <value> | Sort field: priority|deadline|updated_at|created_at|title|parent (aliases: updated, created) | optional |
| --order <value> | Sort order: asc|desc (requires --sort) | optional |
| --tree | Render rows in parent/child tree order | optional |
| --tree-depth <n> | Maximum recursion depth with --tree (0 keeps root rows only) | optional |
| --format <value> | Output render mode: csv|table (human export) or json|ndjson|toon (machine output override) | optional |
| --stream | Emit line-delimited JSON rows (requires --json) | optional |
| --has-notes | Show only items that have notes | optional |
| --has-learnings | Show only items that have learnings | optional |
| --has-files | Show only items that have linked files | optional |
| --has-docs | Show only items that have linked docs | optional |
| --has-tests | Show only items that have linked tests | optional |
| --has-comments | Show only items that have comments | optional |
| --has-deps | Show only items that have dependencies | optional |
| --has-body | Show only items that have a non-empty body | optional |
| --has-linked-command | Show only items whose linked tests carry a runnable command | optional |
| --no-notes | Show only items that have no notes | optional |
| --no-learnings | Show only items that have no learnings | optional |
| --no-files | Show only items that have no linked files | optional |
| --no-docs | Show only items that have no linked docs | optional |
| --no-tests | Show only items that have no linked tests | optional |
| --no-comments | Show only items that have no comments | optional |
| --no-deps | Show only items that have no dependencies | optional |
| --empty-body | Show only items with an empty body | optional |
| --no-linked-command | Show only items whose linked tests carry no runnable command | optional |
| --filter-reviewer-missing | Show only items missing reviewer | optional |
| --filter-risk-missing | Show only items missing risk | optional |
| --filter-confidence-missing | Show only items missing confidence | optional |
| --filter-sprint-missing | Show only items missing sprint | optional |
| --filter-release-missing | Show only items missing release | optional |
Examples
pm list --limit 20