A local-first workbench for the sessions coding agents leave behind.
Browse, search, understand, and continue work across Pi and other coding agents -- without putting another Agent GUI between you and them.
Releases · Documentation · 中文 · Demo · Dataset · Extensions
UI Preview
| Home | Session Page |
|---|---|
 |
 |
| Session Tree | Kanban |
|---|---|
 |
 |
Install
Desktop App
Download the latest build for macOS, Windows, or Linux from GitHub Releases.
CLI / Headless Server
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/dwsy/pi-session-manager/main/scripts/install-cli.sh | bashWindows PowerShell:
iwr -useb https://raw.githubusercontent.com/dwsy/pi-session-manager/main/scripts/install-cli.ps1 | iex
The installers download the latest pi-session-cli, verify SHA256 when available, configure the install path, and handle platform quarantine metadata.
Core Capabilities
- Scan and index sessions from Pi and external sources including Claude Code, Codex, OpenCode, Gemini CLI, Cursor, and Antigravity.
- Browse by list, project, tree, and kanban views; organize with tags, favorites, names, and metadata.
- Search across sessions and in-session messages with full-text indexing, highlights, labels, and source filters.
- Reconstruct work through conversation trees, Branch Atlas, tool-call rendering, compaction context, and trace views.
- Resume, convert, or export sessions and hand work back to the original terminal or agent workflow.
- Review activity through heatmaps, token trends, model usage, cost statistics, and session datasets.
- Run as a Tauri desktop app, a browser-accessible headless server with HTTP/WebSocket APIs, or static demo and dataset builds.
- Use the built-in
en-US,zh-CN,ja-JP,de-DE,fr-FR, andes-ESlanguage packs.
The Idea
Coding agent sessions are more than disposable chat logs. They contain decisions, commands, failed attempts, tool traces, and the context needed to continue unfinished work.
Pi Session Manager treats those sessions as durable, inspectable project artifacts. It indexes and organizes existing session sources while leaving execution to the agents and terminals that created them.
PSM manages the work around the agent, not the agent itself.
| Session workspace | Knowledge layer | Observability layer |
|---|---|---|
| Organize, tag, search, export, and resume past work. | Find decisions and context across sessions and datasets. | Inspect branches, tool calls, traces, activity, tokens, and cost. |
What PSM Is -- and Is Not
| PSM is | PSM is not |
|---|---|
| A local-first library for coding-session history | Another Codex-style agent GUI |
| A cross-agent index, viewer, and continuity layer | A replacement for Pi, Claude Code, Codex, or their native workflows |
| An extensible surface for understanding session artifacts | A chat shell that requires AI features for basic session management |
Extension Boundaries
PSM keeps agent execution and session management separate through two extension layers:
| Layer | Purpose |
|---|---|
| Pi Agent extensions | Connect Pi runtime commands, status, naming, search, and resume workflows to the session library. |
| PSM browser plugins | Add views, renderers, search, analysis, records, commands, and optional agent-assisted workflows around existing sessions. |
Agent-assisted summaries, semantic search, review, and side chat are optional plugins. The core product remains useful without them: sessions can still be browsed, searched, understood, organized, and resumed.
PSM browser plugins can come from built-in packages, npm packages, local .js / .mjs files, or local development projects. Permissions are declared in each manifest and surfaced in Settings -> PSM Plugins.
Start here:
- extensions/README.md - extension overview and development workflow.
- agent-docs/06-plugins.md - plugin authoring boundaries and verification.
- docs/PSM_PLUGIN_SDK.md - public browser-plugin SDK contract.
- docs/PSM_PLUGIN_SDK_CAPABILITY_AUDIT.md - current capabilities and remaining gaps.
License
MIT
macOS Installation Note
If macOS shows "App is damaged and can't be opened", run:
sudo xattr -rd com.apple.quarantine "/Applications/Pi Session Manager.app"This is standard Gatekeeper behavior for non-App-Store apps. No certificate is required for personal use.