Comandos · pm

lifecycle

pm claim: Claim an item for active work.
pm close: Close an item. Close reason requirement follows governance.require_close_reason.
pm close delete: Delete an item and record the change in history.
pm close many: Bulk-close matched items with a shared reason and full runClose semantics (dry-run + rollback checkpoint).
pm release: Release ownership.
pm update: Update item fields and metadata.
pm update many: Bulk-update matched items with dry-run plans and rollback checkpoints.

context

pm aggregate: Group item counts and numeric measures.
pm context: Show a token-efficient project context snapshot for next-work decisions.
pm context next: Recommend the next actionable (unblocked, ready) work item with rationale + blocked companion.
pm get: Show item details by ID.
pm history activity: Show recent activity across items.
pm item duplicates: Find duplicate clusters across all statuses.
pm list: List active items with optional lifecycle-status and project filters.
pm ops eval: Evaluate search relevance against a curated golden-query set: reports nDCG@k, MRR@k, precision@k, and recall@k per query plus the macro average. Use --fail-under as a CI gate.
pm ops stats: Show project tracker statistics.
pm search: Search items with keyword, semantic, or hybrid retrieval. Inline field:value tokens (tag:/status:/type:/priority:) in the query are parsed as filters, e.g. 'auth tag:area:search status:open'.

intake

pm context focus: Set/clear/show the session focused item that new items default --parent to.
pm create: Create a new project management item.
pm history restore: Restore an item to an earlier timestamp or version.
pm item: Run item lifecycle operations.
pm item copy: Copy an item into a new item id while resetting lifecycle fields.

evidence

pm history: Show item history entries.
pm history acknowledge: Append audited dispositions for immutable unknown-author events.
pm history attest: Export exact-byte history commitments, or verify an independently retained proof without tracker writes.
pm history compact: Compact item history streams into a synthetic baseline plus retained tail entries. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to compact many.
pm history events: Emit cursor-resumable committed mutation facts as newline-delimited JSON.
pm history redact: Redact sensitive literals/patterns from an item history stream and recompute hashes.
pm history repair: Re-anchor a drifted item history chain (recompute hashes, reconcile with the on-disk item) and record an audit marker. Use --all to repair every drifted stream.
pm item append: Append text to an item's body. For concurrent writes, use pm notes.
pm item comments: List, add, edit, or delete comments for an item.
pm item docs: Manage docs linked to an item.
pm item files: Manage files linked to an item.
pm item learnings: List, add, edit, or delete learnings for an item.
pm item notes: Manage merge-safe text notes and JSON context events.

quality

pm assurance: Manage SDK-owned assurance contracts.
pm contracts: Show machine-readable command and schema contracts for agents.
pm item test: Manage tests linked to an item and optionally run them.
pm ops: Discover workspace diagnostics and maintenance operations.
pm ops test-all: Run linked tests across matching items.
pm ops validate: Validate metadata, lifecycle policies, files, command references, and history.

workspace

pm ops gc: Delete optional cache artifacts by default (including expired lock debris) and show a summary.
pm ops health: Show project tracker health checks.
pm ops telemetry: Inspect and manage local telemetry queue/runtime state.
pm workspace: Inspect workspace state and snapshots.
pm workspace config: Read or update pm settings for the current workspace or global profile.
pm workspace init: Initialize pm storage and defaults for the current workspace or a path-like tracker target.
pm workspace merge: Install merge drivers, reconcile or report post-merge history, or run a field-aware driver.
pm workspace profile: List, show, apply, and lint project profiles — archetype bundles of item types, statuses, fields, workflows, config, templates, and recommended packages.
pm workspace schema: Manage types, statuses, fields, presets, and workflow policies.

graph

pm graph: Bounded workspace relationship-graph queries, analytics, and governance audit.
pm item deps: Show dependency relationships for an item.
pm plan: Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.

extensions

pm package: Manage package lifecycle in project or global scope.

internal

pm assurance apply: Apply one assurance adoption preset.
pm assurance derive: Derive assurance proposals from current project context.
pm assurance lineages: Measure all recorded recurrence lineages with bounded evidence rows.
pm assurance list: List assurance declarations by kind.
pm assurance presets: List available assurance adoption presets.
pm assurance promote: Promote one assertion into a warning or blocking gate.
pm assurance put: Put assurance declarations by kind.
pm assurance remove: Remove assurance declarations by kind.
pm assurance risk: Analyze bounded defect-recurrence risk for a proposed change.
pm assurance run: Evaluate one assurance gate for a lifecycle trigger.
pm assurance show: Show assurance declarations by kind.
pm assurance verdicts: List bounded assurance verdict history.
pm extension activate: Activate a extension in selected scope settings.
pm extension adopt: Adopt an existing unmanaged extension into managed metadata.
pm extension adopt-all: Adopt all unmanaged extensions into managed metadata.
pm extension catalog: List bundled first-party extension catalog metadata.
pm extension deactivate: Deactivate a extension in selected scope settings.
pm extension describe: Map every surface a loaded extension registers (commands, hooks, item types, providers, overrides, ...).
pm extension doctor: Run consolidated extension diagnostics (summary/deep modes).
pm extension explore: List discovered extensions in selected scope.
pm extension init: Generate a starter extension scaffold with manifest and entrypoint.
pm extension install: Install extension from local path, bundled alias, npm: source, wildcard, or GitHub source.
pm extension manage: List managed extensions with update-check metadata.
pm extension migrate: Plan or apply active extension migrations with durable receipts.
pm extension reload: Reload extensions with cache-busted module imports.
pm extension uninstall: Uninstall an installed extension.
pm item complete: Close with evidence and release the claim.
pm item mutate: Apply SDK-backed mutations atomically.
pm item reopen: Reopen terminal work with recurrence evidence.
pm package activate: Activate a package in selected scope settings.
pm package adopt: Adopt an existing unmanaged package into managed metadata.
pm package adopt-all: Adopt all unmanaged packages into managed metadata.
pm package catalog: List bundled first-party package catalog metadata.
pm package deactivate: Deactivate a package in selected scope settings.
pm package describe: Map every surface a loaded package registers (commands, hooks, item types, providers, overrides, ...).
pm package doctor: Run consolidated package diagnostics (summary/deep modes).
pm package explore: List discovered packages in selected scope.
pm package init: Generate a starter package scaffold with package metadata, manifest, and entrypoint.
pm package install: Install package from local path, bundled alias, npm: source, wildcard, or GitHub source.
pm package manage: List managed packages with update-check metadata.
pm package migrate: Plan or apply active package migrations with durable receipts.
pm package reload: Reload packages with cache-busted module imports.
pm package uninstall: Uninstall an installed package.
pm package upgrade: Upgrade the pm CLI/SDK and refresh managed installable pm packages.
pm plan add-step: Append one ordered step to a Plan item.
pm plan approve: Approve for one Plan item.
pm plan block-step: Block one declared Plan step.
pm plan complete-step: Complete one declared Plan step.
pm plan create: Create a Plan item and optionally seed its ordered steps.
pm plan decision: Decision for one Plan item.
pm plan discovery: Discovery for one Plan item.
pm plan link: Link one dependency to a declared Plan step.
pm plan materialize: Materialize for one Plan item.
pm plan remove-step: Remove one declared Plan step.
pm plan reorder-step: Move one Plan step to a declared integer order.
pm plan resume: Resume for one Plan item.
pm plan show: Read one Plan item with a bounded plan projection.
pm plan unlink: Unlink one dependency from a declared Plan step.
pm plan update-step: Update one declared Plan step.
pm plan validation: Validation for one Plan item.
pm workspace position: Read bounded merge-fence, receipt, history-drift, and next-action readiness.
pm workspace snapshot: Manage content-addressed tracker snapshots.
pm workspace snapshot create: Capture authoritative tracker state as an immutable snapshot.
pm workspace snapshot delete: Delete one workspace snapshot target.
pm workspace snapshot inspect: Inspect one workspace snapshot target.
pm workspace snapshot list: List immutable workspace snapshots and named references.
pm workspace snapshot restore: Restore an immutable workspace snapshot with explicit recovery controls.