@hcflabs/pi-notes
Persistent notes in a Pi widget, managed with /note commands.
Package details
Install @hcflabs/pi-notes from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@hcflabs/pi-notes- Package
@hcflabs/pi-notes- Version
3.2.4- Published
- Oct 24, 2026
- Downloads
- 219/mo · 23/wk
- Author
- csubj
- License
- MIT
- Types
- extension
- Size
- 284.4 KB
- Dependencies
- 1 dependency · 2 peers
Pi manifest JSON
{
"image": "https://raw.githubusercontent.com/hcflabs/pi-harness/main/extensions/pi-notes/example.png",
"extensions": [
"./extensions/notes.ts"
]
}
Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@hcflabs/pi-notes
Keep worktree reminders above the Pi editor across sessions.
Install
pi install npm:@hcflabs/pi-notesUse
Run /note Verify the migration rollback. in a Git worktree. The reminder appears immediately and in later sessions.
These commands and the widget are for people.
| Surface | Type | Purpose |
|---|---|---|
/note <text> |
command | Add a worktree note. |
/note-rm |
command | Select and remove a note. |
/note-clear |
command | Clear worktree notes. |
| Notes widget | ui | Show worktree notes. |
Each worktree has separate notes. The TUI numbers notes and limits each to two lines. Other modes show plain text without that limit. Empty widgets stay hidden.
State and storage
Commands save notes to ~/.pi/agent/config/pi-notes/<worktree-sha256>.json.
Session start and note changes silently delete stale files for removed repositories and worktrees.
Limits and recovery
Each worktree holds at most four notes. /note trims surrounding whitespace and replaces whitespace sequences with one space. It rejects remaining control characters with Notes cannot contain terminal control characters.
The extension validates files as untrusted data. Malformed files stay unchanged and block changes for their worktree. Fix the file or reset it with /note-clear.