@firstpick/pi-extension-notes

Local notes CRUD extension for Pi with optional rule-note prompt injection.

Package details

← Back
extension

Install @firstpick/pi-extension-notes from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@firstpick/pi-extension-notes
Package
@firstpick/pi-extension-notes
Version
0.1.4
Published
May 5, 2026
Downloads
461/mo · 461/wk
Author
firstpick
License
MIT
Types
extension
Size
14.5 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extension-notes

Local notes management for Pi with optional rule-note prompt injection.

What it does

  • Create, list, read, update, and delete local markdown notes.
  • Uses fuzzy lookup for fast retrieval/editing.
  • Stores notes in a transparent file-based structure.
  • Optionally injects rule* notes into the system prompt at startup.

Install

pi install npm:@firstpick/pi-extension-notes

Configuration

  • PI_NOTES_DIR
    • Optional custom notes storage directory.
    • Default: ~/.pi/agent/memory/notes
  • PI_NOTES_INCLUDE_RULES_IN_PROMPT
    • 1|true|yes|on: inject rule notes into system prompt on start.
    • unset/other: keep rule notes stored but do not inject.

Commands

  • /note <title> :: <content> or /note <content> — create/save a note.
  • /note-list — list notes (newest first).
  • /note-read [slug|query] — read a note (fuzzy match).
  • /note-update <slug|title> :: <content> — update a note.
  • /note-delete <slug|title> — delete a note (with confirmation in UI).
  • /note-status — show notes directory and rule-injection status.

Tools

None.