All commands · evidence
pm item notes
Manage merge-safe text notes and JSON context events.
Adds or reviews durable implementation notes linked to an item.
Usage
pm item notes [options] <id> [text]Arguments
| <id> | Item id | required |
|---|---|---|
| <text> | Optional note text shorthand for --add | optional |
Options
| --add <text> | Add a text note (- reads stdin) | optional |
|---|---|---|
| --add-json <json> | Append a JSON event | optional |
| --stdin | Read note text from stdin | optional |
| --file <path> | Read note from file or stdin (-) | optional |
| --edit <index> | Replace a 1-based note using the selected text input | optional |
| --delete <index> | Delete the note at 1-based <index> | optional |
| --limit <n> | Return only latest n notes | optional |
| --since <timestamp> | Filter JSON events from this ISO time | optional |
| --event-type <value> | Filter JSON events by top-level type | optional |
| --include-meta | Include count and truncation metadata | optional |
| --full-history | Return complete note history instead of a bounded receipt | optional |
| --if-absent | Append only when resolved author and text are absent | optional |
| --author [value] | Author; defaults to PM_AUTHOR/settings | optional |
| --message <value> | History message | optional |
| --force | Force ownership override | optional |
Examples
pm item notes pm-a1b2 --add "Investigated parser edge case and documented fallback logic."