$ cat ~/map/pi-session-manager.md
Pi Session Manager
A local-first desktop workbench for browsing, searching, and resuming Pi sessions.
tools✓ Oct 16
Facts
- repository
- github.com/Dwsy/pi-session-manager ↗
- GitHub Stars
- ★ 197
- Forks
- 14
- license
- —
- npm / mo
- —
- last push
- Oct 8, 2026
install
curl -fsSL https://raw.githubusercontent.com/dwsy/pi-session-manager/main/scripts/install-cli.sh | bash## TL;DR
A local-first workbench for the sessions coding agents leave behind — browse, search, reconstruct, and resume sessions from pi plus Claude Code, Codex, OpenCode, Gemini CLI, Cursor, and Antigravity, as a Tauri desktop app or headless server.
## Key points
- $Scans and indexes sessions from pi and external sources including Claude Code, Codex, OpenCode, Gemini CLI, Cursor, and Antigravity; treats sessions as durable, inspectable project artifacts rather than disposable chat logs.
- $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.
- $Reconstructs work through conversation trees, Branch Atlas, tool-call rendering, compaction context, and trace views; sessions can be resumed, converted, or exported and handed back to the original terminal or agent workflow.
- $Reviews activity through heatmaps, token trends, model usage, cost statistics, and session datasets.
- $Runs as a Tauri desktop app (builds for macOS, Windows, and Linux on GitHub Releases), a browser-accessible headless server with HTTP and WebSocket APIs, or static demo and dataset builds; the CLI installers verify SHA256 when available.
- $Ships language packs for en-US, zh-CN, ja-JP, de-DE, fr-FR, and es-ES.
- $Two extension layers keep concerns separate: pi agent extensions connect runtime commands, status, naming, search, and resume workflows to the session library, while PSM browser plugins (built-in packages, npm packages, local .js/.mjs files, or dev projects) add views and renderers with manifest-declared permissions.
- $Agent-assisted summaries, semantic search, review, and side chat are optional plugins — the core remains useful without them, and PSM positions itself as managing the work around the agent, not the agent itself.
## FAQ
Q Is this a replacement for pi's own interface?
No — PSM is a local-first library, index, viewer, and continuity layer for session history, not another Codex-style agent GUI and not a replacement for pi, Claude Code, Codex, or their native workflows.
Q Do I need AI features to manage sessions?
No — agent-assisted summaries, semantic search, review, and side chat are optional browser plugins; browsing, searching, understanding, organizing, and resuming sessions all work without them.
Q How do I install the CLI or desktop app?
Download the desktop build for macOS, Windows, or Linux from GitHub Releases, or install the headless CLI with the install-cli.sh script on macOS and Linux and install-cli.ps1 in Windows PowerShell; the installers verify SHA256 when available.
## References
## Related entries
$ PiDeck
Native desktop GUI for the pi coding agent — streaming chat, tool-call inspector, sessions, in-app package manager for extensions/skills/themes, built-in git, and bilingual UI.
$ Pier
macOS desktop client for pi: streams sessions over pi --mode rpc with diffs, follow-ups, and extension dialogs.
$ CCompactor
Turns finished coding-agent sessions — Pi, Claude Code, Codex — into compact, verified, provenance-linked handoff artifacts, in TypeScript.
## Guides
Last updated: Aug 31, 2026