All commands · evidence
pm history events
Emit cursor-resumable committed mutation facts as newline-delimited JSON.
Emit cursor-resumable committed mutation facts as newline-delimited JSON.
Usage
pm history events [options]Options
| --since <cursor-or-timestamp> | Resume strictly after a durable cursor, or include events from an ISO timestamp | optional |
|---|---|---|
| --type <value> | Filter by mutation operation (repeatable or comma-separated) | optional |
| --author <value> | Filter by mutation author (repeatable or comma-separated) | optional |
| --item <value> | Filter by item or workspace stream id (repeatable or comma-separated) | optional |
| --limit <n> | Return at most 1,000 events (default: 100) | optional |
| --cursor-mode <mode> | Cursor framing: batch emits one terminal trailer (default); row preserves one cursor per event | optional |
| --full | Include each complete authoritative history entry | optional |
| --provenance | Include patch-free author, harness, instance, and extensible provenance | optional |
| --provenance-summary | Include bounded provenance completeness counts | optional |
| --harness <value> | Filter by recorded or vocabulary-resolved harness (repeatable) | optional |
| --agent-instance <value> | Filter by privacy-safe agent instance (repeatable) | optional |
| --provenance-filter <dimension=value> | Filter by an exact declared provenance value (repeatable) | optional |
| --follow | Continue emitting committed events as newline-delimited JSON | optional |
| --interval-ms <n> | Empty-read delay while following (minimum: 10ms; default: 250ms) | optional |
Examples
pm history events --help