repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

extensions/notes/README.md

Raw

notes

Session-backed pending prompt notes for Pi.

Install / load

Loaded through the root pi-ext package. See root README.

Commands / tools / settings

Commands:

Shortcut:

Tools: none.

Settings: none.

Behavior

Pending notes are persisted as notes-state custom session entries. Custom entries are invisible to the model context. Notes are branch-local because state is reconstructed from the current session branch, including after /tree navigation. After /new, Pi asks whether to copy pending notes into the new session. The handoff is in memory, so it works before either session file exists. The widget is compact on reload, resume, or tree navigation.

No persistent project-global storage exists. No cross-session note list exists. No system-prompt or model-context injection exists. No steer mode exists.

Markdown source
# notes

Session-backed pending prompt notes for Pi.

## Install / load

Loaded through the root pi-ext package.
See [root README](../../README.md).

## Commands / tools / settings

Commands:

- `/note` — toggle the notes widget between compact and expanded mode.
- `/note add <text>` — park a non-empty note.
- `/note send <id>` — send one note as an exact user follow-up and remove it from pending notes.
- `/note edit <id>` — edit one pending note.
- `/note rm <id>` — remove one pending note.
- `/note clear` — confirm and remove all pending notes.

Shortcut:

- `alt+n` — same as `/note`.

Tools:
none.

Settings:
none.

## Behavior

Pending notes are persisted as `notes-state` custom session entries.
Custom entries are invisible to the model context.
Notes are branch-local because state is reconstructed from the current session branch, including after `/tree` navigation.
After `/new`, Pi asks whether to copy pending notes into the new session.
The handoff is in memory, so it works before either session file exists.
The widget is compact on reload, resume, or tree navigation.

No persistent project-global storage exists.
No cross-session note list exists.
No system-prompt or model-context injection exists.
No steer mode exists.