@pixu1980/pi-sessions
Session history overlay for pi.dev - browse, search, and restore past sessions with auto-naming based on chat content
Package details
Install @pixu1980/pi-sessions from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@pixu1980/pi-sessions- Package
@pixu1980/pi-sessions- Version
0.1.7- Published
- Aug 1, 2026
- Downloads
- 258/mo · 16/wk
- Author
- pixu1980
- License
- MIT
- Types
- extension
- Size
- 48.7 KB
- Dependencies
- 0 dependencies · 2 peers
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-sessions
Session history overlay for pi.dev. Browse, search, and restore past sessions with auto-naming based on chat content.
Screenshot idea: A centered modal listing past sessions with auto-names, dates, message counts, and model info.
Features
- 📋 Session browser - Centered modal, matching
/mcp, shows all past sessions - 📁 Project overview -
/projectsgroups sessions by project directory with aggregated metadata - 🏷️ Auto-naming - Sessions are named from the first user message content
- 🔍 Search/filter - Type to filter by name, model, or project path
- ↕️ Keyboard navigation - ↑↓ arrows, Home/End, PageUp/PageDown
- ⏪ One-click restore - Select a session to load it with full context
- 📊 Session details - Date, message count, model used, provider
- 📁 Folder first - Each session shows the project directory prominently
- 💬 Last message - Shows the last user message instead of just the first one
Install
pi install npm:@pixu1980/pi-sessions
Usage
Session list
/sessions
Shows all sessions in a flat list with folder, last message, and metadata.
Project overview (drill-down)
/projects
Shows sessions grouped by project directory with aggregated info:
- Project path, latest message, session count, total messages, model used
- Select a project → drill-down to individual sessions
- Esc in drill-down returns to project list
Navigation
| Key | Action |
|---|---|
| ↑ / ↓ | Navigate |
| Enter | Select session (flat) / Drill down (projects) |
| Type text | Filter by project, message, model |
| Backspace | Clear filter |
| Home / End | Jump to first/last |
| PageUp / PageDown | Scroll page |
| Esc | Close overlay / Go back (projects drill-down) |
Auto-naming
The extension automatically names each session from the first user message, truncated to 60 characters.
Each session entry shows:
- 📁 Folder - Project directory path
- 💬 Last message - Last user message content (truncated)
- 📊 Metadata - Relative date, message count, model, provider
Project overview (/projects)
Groups sessions by project directory. Each project shows:
- 📁 Project path - Project directory
- 💬 Latest message - Last user message from the most recent session
- 📊 Aggregated metadata - Session count, total messages, latest model
Select a project to drill down into its individual sessions.
How it works
- Opens a centered loading modal immediately
- Scans
~/.pi/agent/sessions/asynchronously with bounded concurrency - Parses each session to extract message previews, counts, model and provider
- Reuses the same modal for search and selection
- On selection, uses
ctx.switchSession()to load the session
License
MIT