@vanillagreen/pi-session-manager
v1.5.2
Published
Polished Pi session manager overlay for browsing, searching, resuming, renaming, and safely deleting sessions.
Maintainers
Readme
pi-session-manager

Polished session manager overlay. Complements Pi's built-in /resume with search, lineage view, rename, and safe delete.
Highlights
- Browse current-project sessions or all sessions.
- Search by tokens, quoted phrases, or
re:<regex>. - Reads session prompt snippets line-by-line, so very large session JSONL files do not have to be materialized just to browse or search.
- Threaded lineage view follows Pi
parentSessionrelationships. - Detail pane shows each session CWD plus its saved model.
- Resume preserves the session's saved model. If your active model differs, a confirmation lets you pick either.
- Inline rename and delete with confirmation. Optional
trashCLI fallback so deletes are recoverable. - Deleting a session also clears its per-extension data.
Install
Via npm:
pi install npm:@vanillagreen/pi-session-managerVia vstack:
cargo install --git https://github.com/vanillagreencom/vstack.git vstack
vstack add vanillagreencom/vstack --pi-extension pi-session-manager --harness pi -yRestart Pi after installation.
Commands
| Command | Action |
| --- | --- |
| /sessions | Open the manager. Switch Current/All with the tabs. |
The manager popup documents its own keys in the footer. Selection, rename, delete, scope toggle, sort cycle, and named-only filter are all available; bindings are configurable via /extensions:settings.
Session titles match Pi /resume: explicit session name, otherwise first user message, otherwise filename. Search filters the shown list; delete-all acts only on the currently shown sessions.
Settings
Open /extensions:settings; settings appear under the Session Manager tab.
Project settings in .pi/settings.json apply only after Pi marks the workspace trusted; before trust, vstack Pi extensions read user/global settings only.
| Setting | What it does |
| --- | --- |
| Manager shortcut | Default f1. Set none to disable. |
| Default scope | Initial Current/All tab. |
| Default sort | threaded, recent, or relevance. |
| Visible rows | Rows shown before scrolling. |
| Overlay width | Preferred width in terminal columns. |
| Use trash for delete | Try trash before permanent unlink. |
Glyph style: each package exposes glyphStyle (unicode default, ascii for terminal-safe chrome). @vanillagreen/pi-tool-renderer.globalGlyphStyleOverride=ascii forces ASCII chrome across vstack Pi extensions while leaving tool/model/user content unchanged.
Notes
Pi's built-in /resume, /tree, /fork, /clone, and /name remain available.
