Pi Session Hub

pi-session-hub

One list for every coding-agent session on your machine. Browse, search and continue sessions from Claude Code, Codex, OpenCode, Crush and JCode without leaving Pi.

pi-session-hub adds a cross-harness session browser to Pi:

- See every agent in one list: Pi, Claude Code, Codex, OpenCode, Crush and JCode sessions, each row labelled with its harness, project, model and recency.
- Continue work that started elsewhere: press Enter and the selected session's conversation is loaded into the current chat as a tiered, budgeted context package, so the next thing you type already has it.
- Read without spending tokens: v opens the full recovered transcript in a read-only viewer for free.
- Reopen the original tool when you want to: n runs the session's own resume command, with the exact command and its verification basis shown before anything is launched.
- Stay local and read-only: nothing outside ~/.pi/agent/pi-session-hub/ is ever written, no transcript leaves the machine, and no external session is ever disguised as a Pi session.

Package facts

Public surfaces

Commands: /session-hub, /hub, /session-search, /session-open, /session-handoff, /session-native.

Tools: session_hub_search, session_hub_context.

Shortcut: alt+r.

Skill: session-hub, which tells the agent when to reach for session_hub_search on its own.

Why use it?

Install

Try it without installing:

Quick start

1. Install the package and start Pi in any project.

2. Open the hub:

   Or type /session-hub, or /hub. The hub replaces Pi's UI area rather than floating over the chat. For a true alternate-screen takeover, set Pi's own tuiMode to "fullscreen" in ~/.pi/agent/settings.json.

3. The first run indexes your harnesses. On a machine with 430 sessions this takes about two seconds; later…