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 Features

• Session Browser — List, project, directory, and Kanban views with favorites and batch export
• Full-Text Search — SQLite FTS5 + Tantivy with role filters, session ID matching, and snippet highlighting
• Session Viewer — Tree view, flow visualization (React Flow), collapsible tool calls and thinking blocks
• Dashboard — Activity heatmap, project mix, model usage, token costs, achievements
• Built-in Terminal — Integrated xterm.js with PTY backend for resuming sessions
• Hierarchical Tags — Parent-child tag tree with auto-rules
• Multi-Platform — Desktop, mobile web, and headless CLI mode
• Multi-Protocol API — Tauri IPC, WebSocket, and HTTP all sharing one command router

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?