Getting Started

What is Pi Session Manager?

Pi Session Manager is a cross-platform application for browsing, searching, and managing Pi AI coding sessions. It works as a native desktop app (macOS, Windows, Linux), a responsive mobile web app, and a headless server — all from a single codebase.

"The best tool is the one that gets out of your way." — Jef Raskin

Whether you're reviewing past conversations, searching for a specific code snippet across hundreds of sessions, or tracking your AI-assisted development workflow on a Kanban board, Pi Session Manager has you covered.

Key Capabilities

• Session Browser — List, project, directory, and Kanban views with favorites, batch export, and multi-path scanning. See Session Browser.
• Search and Recall — SQLite FTS5, role filters, session ID matching, snippet highlighting, and command palette search. See Search.
• Dashboard and Analytics — Activity heatmap, project mix, model usage, token costs, and achievement tracking. See Dashboard.
• API and Automation — HTTP, WebSocket, and SSE APIs share one command router for programmatic access. See API Reference.
• Extension System — Built-in, npm, and local path plugins with a browser-plugin SDK for app views, commands, tools, and settings. See plugin SDK and Extensions README.
• Pi Live and Bridge Sync — Live session sync, context recall, tags, and bridge-based workflows for Pi CLI users. See psm-bridge.
• Terminal and Workspace Tools — Integrated PTY terminal, session resume, hierarchical tags, and multi-platform support. See Terminal and Tags.

UI Preview

Home	Session Page
Session Tree	Kanban

Quick Install

Desktop App

Download the latest release for your platform from GitHub Releases:

CLI / Headless Server

Download the pi-session-cli binary from the same release page, or build with Docker:

docker build -f Dockerfile.cli -t pi-session-cli .
docker cp $(docker create pi-session-cli):/pi-session-cli ./pi-session-cli
chmod +x pi-session-cli
./pi-session-cli

First Launch

1. Open the app — sessions from ~/.pi/agent/sessions/ are scanned automatically
2. Browse sessions — switch between list, project, directory, or Kanban views
3. Search — press Cmd/Ctrl + K for the command palette, or Cmd/Ctrl + F for sidebar search
4. View a session — click any session to open the viewer with tree navigation and flow visualization
5. Open terminal — press Cmd/Ctrl + J to toggle the built-in terminal

What's Next?