@pixu1980/pi-sessions

Session history overlay for pi.dev - browse, search, and restore past sessions with auto-naming based on chat content

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@pixu1980/pi-sessions
Package
@pixu1980/pi-sessions
Version
0.1.3
Published
Jul 11, 2026
Downloads
224/mo · 203/wk
Author
pixu1980
License
MIT
Types
extension
Size
36.5 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 right-side overlay panel listing past sessions with auto-names, dates, message counts, and model info.

Features

  • 📋 Session browser - Sidebar overlay (right side) shows all past sessions
  • 📁 Project overview - /projects groups 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

  1. Scans ~/.pi/agent/sessions/ for session JSONL files
  2. Parses each session to extract: first message text, message count, model info
  3. Shows them in a right-side overlay panel
  4. On selection, uses ctx.switchSession() to load the session

License

MIT

Author

Emiliano 'pixu1980' Pisu