@vanillagreen/pi-session-manager

Polished Pi session manager overlay for browsing, searching, resuming, renaming, and safely deleting sessions.

Packages

Package details

extension

Install @vanillagreen/pi-session-manager from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@vanillagreen/pi-session-manager

Package: @vanillagreen/pi-session-manager
Version: 1.3.3
Published: May 19, 2026
Downloads: 1,522/mo · 463/wk
Author: vanillagreencom
License: MIT
Types: extension
Size: 217.2 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/session-manager.ts"
  ],
  "image": "https://raw.githubusercontent.com/vanillagreencom/vstack/main/pi-extensions/pi-session-manager/assets/session-manager.png"
}

Security note

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

README

pi-session-manager

Session Manager overlay and model-change confirmation

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>.
Threaded lineage view follows Pi parentSession relationships.
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 trash CLI fallback so deletes are recoverable.
Deleting a session also clears its per-extension data.

Install

Via npm:

pi install npm:@vanillagreen/pi-session-manager

Via vstack:

cargo install --git https://github.com/vanillagreencom/vstack.git vstack
vstack add vanillagreencom/vstack --pi-extension pi-session-manager --harness pi -y

Restart 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.

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.

Notes

Pi's built-in /resume, /tree, /fork, /clone, and /name remain available.