pi-session-manager

A session browser extension for the pi coding agent. Browse, resume, rename, and delete sessions from an interactive TUI overlay — without leaving your current conversation.

Install

pi install npm:pi-session-manager

Features

• Browse sessions — interactive fuzzy-searchable list with age, message count, and working directory
• Resume — switch to any previous session instantly
• Delete — remove sessions with a confirmation prompt
• Rename — give sessions a meaningful name (current session only; use /name for others)
• Scope toggle — switch between current project and all projects with Tab
• Status bar — active session name shown persistently in the footer when set

Commands

Command	Description
/sessions	Browse sessions for the current working directory
/sessions all	Browse sessions across all projects
/sall	Shorthand for /sessions all

Keyboard Shortcuts

Inside the session browser:

Key	Action
↑ / ↓	Navigate sessions
Enter	Resume selected session
d	Delete selected session
n	Rename selected session
Tab	Toggle scope (current project ↔ all projects)
Esc	Close browser

Type to filter sessions by title, message content, or working directory.

How It Works

The extension registers two commands and a session_start hook:

• On session_start, it reads the active session's name and renders it in the status bar (e.g. 📁 my-feature).
• /sessions / /sall open a centered overlay built with pi's TUI primitives (SelectList, Container, DynamicBorder).
• Sessions are loaded via SessionManager.list() (current directory) or SessionManager.listAll() (global), sorted newest-first.
• The list displays a human-readable title (session name → first message → filename fallback), age, message count, and a shortened working directory path.
• Resuming a session calls ctx.switchSession(). If the session has a name, the status bar is updated immediately.
• Rename only works on the currently active session; for other sessions, you must resume first and then use /name.

Requirements

• pi coding agent with TUI support

License

MIT