@tribalnerd/pi-notes

A Pi extension for deterministic human notes across project and global scopes.

Package details

extensionskill

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

$ pi install npm:@tribalnerd/pi-notes

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

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

A human-first notes extension for Pi, built to keep quick notes organized, searchable, and safe directly inside your Pi workflow.

pi-notes adds a /notes command family to Pi so you can create, read, update, search, and safely remove notes without leaving your terminal flow.

Notes are stored in markdown and can live at:

pi install npm:@tribalnerd/pi-notes

This package also ships a pi-notes skill (skills/pi-notes/SKILL.md) for agent-side routing.

Pi extension command family:

/notes (usage/help)
/notes help
/notes commands
/notes setup
/notes ls [--project|--global]
/notes show <name> [--project|--global]
/notes new <name> [--project|--global]
/notes edit <name> [--project|--global]
/notes append <name> <text> [--project|--global]
/notes rm <name> [--project|--global]
/notes grep <query> [--project|--global]
/notes rewrite <name> <instruction> [--project|--global]
/notes move <name> --to-global|--to-project [--project|--global] [--overwrite]
/notes rename <from> <to> [--project|--global] [--overwrite]
/notes uninstall [--project] [--global]

Package CLI (deterministic non-interactive flows):

CLI invocation options:

Examples:

npx @tribalnerd/pi-notes show <name> [--project|--global]
npx @tribalnerd/pi-notes new <name> [--project|--global]
npx @tribalnerd/pi-notes append <name> <text> [--project|--global]
npx @tribalnerd/pi-notes ls [--project|--global]
npx @tribalnerd/pi-notes grep <query> [--project|--global]
npx @tribalnerd/pi-notes move <name> --to-global|--to-project [--project|--global] [--overwrite]
npx @tribalnerd/pi-notes rename <from> <to> [--project|--global] [--overwrite]
npx @tribalnerd/pi-notes rm <name> [--project|--global] [--yes]
npx @tribalnerd/pi-notes uninstall [--project] [--global] [--yes]

Default behavior:

Flags:

Parser semantics:

scope flags are parsed only at argument edges (leading/trailing)
move flags (--to-global, --to-project, --overwrite) are parsed only for /notes move and only at argument edges
flag-like tokens inside content are preserved as literal text
use -- to force all following tokens to be treated literally

MIT — see LICENSE.