pi-replay

Replay Pi session JSONL files in the terminal using Pi's TUI rendering style.

Installation

From npm (recommended)

npm install -g pi-replay
# or
pnpm add -g pi-replay
# or
yarn global add pi-replay

From source

git clone https://github.com/tychenjiajun/pi-replay.git
cd pi-replay
pnpm install
pnpm build
pnpm link --global

Usage

File argument

pi-replay ~/.pi/agent/sessions/--path--/session.jsonl

Stdin pipe

tail -n 20 session.jsonl | pi-replay
cat session.jsonl | pi-replay

Non-interactive mode (print to stdout)

pi-replay session.jsonl --print
pi-replay session.jsonl -p

Interactive Controls

| Key | Action | |-----|--------| | Ctrl+O | Toggle expand/collapse for all tool executions and bash outputs | | Ctrl+T | Toggle thinking blocks visibility | | q or Ctrl+C | Quit |

Features

• Renders Pi session events: session header, model changes, thinking level changes
• User messages with Pi-style background
• Assistant messages with text and thinking blocks
• Tool executions (read, write, edit, bash, etc.) with collapsible output
• Bash command executions with collapsible output
• Markdown rendering with Pi's theme colors
• Collapsed preview mode with expand hints

Implementation

Uses components from:

• @mariozechner/pi-tui - Terminal UI primitives
• @mariozechner/pi-coding-agent - UserMessageComponent, AssistantMessageComponent, theme
• @mariozechner/pi-ai - Message types

Custom components for replay:

• ToolExecution - Simplified tool execution display with expand/collapse
• BashExecution - Simplified bash output display with expand/collapse

Example Output

📌 Session 657be6e9 | cwd: /Users/chenjiajun

 🔧 Model ModelScope/Qwen/Qwen3.5-122B-A10B
 🧠 Thinking level: high

┌─────────────────────────────────────────────────────────────────────────────┐
│ Use agent-browser to check zhibo8.cc and tell me what sports game tonight?  │
└─────────────────────────────────────────────────────────────────────────────┘

 💭 Thinking... (Ctrl+T to expand)

 read /Users/chenjiajun/.pi/agent/skills/agent-browser/SKILL.md
 ---
 name: agent-browser
 description: Browser automation CLI for AI agents...
 (Ctrl+O to expand)

────────────────────────────────────────────────────────────────────────────────
 $ agent-browser open https://zhibo8.cc
 ✓ Done
 (Ctrl+O to expand)
────────────────────────────────────────────────────────────────────────────────

License

MIT