@henryqw/pi-notes
v2.0.1
Published
Persistent notes in a Pi widget, managed with /note commands.
Readme
@henryqw/pi-notes
Keep up to four persistent reminders for each worktree visible above the Pi editor. Small fixed slots stay useful without becoming an unbounded history store.
Install
pi install npm:@henryqw/pi-notesUse
Run /note Verify the migration rollback. The reminder appears above the editor and returns in later sessions for this worktree.
| Surface | Type | Purpose |
| --- | --- | --- |
| /note <text> | command | Add a note for current Git worktree (max 4). |
| /note-rm | command | Pick a note from current worktree to remove. |
| /note-clear | command | Clear current worktree's notes. |
- Each Git worktree has separate notes.
- The widget numbers notes above the editor and shows at most two lines per note.
- Empty worktrees show no widget.
State and storage
The extension generates ~/.pi/agent/config/pi-notes/<worktree-sha256>.json for command-managed notes in one Git worktree.
Stale files for removed repositories and worktrees are deleted silently when a session starts or notes change.
Limits and recovery
Each worktree file is validated as untrusted data. Malformed files are preserved. They block mutation for the affected worktree until fixed or reset with /note-clear.