https://github.com/ygncode/pi-sessions-viewer
https://github.com/ygncode/pi-sessions-viewer
Last synced: 7 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/ygncode/pi-sessions-viewer
- Owner: ygncode
- Created: 2026-04-25T02:33:06.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-06T14:03:09.000Z (about 2 months ago)
- Last Synced: 2026-05-06T15:48:06.094Z (about 2 months ago)
- Language: JavaScript
- Size: 85.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# pi-sessions-viewer
A local web viewer for [pi](https://pi.dev) coding agent sessions.
Browse, search, and share all your pi sessions from a browser. Renders sessions using the same HTML/CSS as pi's `/export` command, with live incremental updates as you chat.
## Features
- **Session browser** - Grid view of all sessions, grouped by project
- **Tree navigation** - Full session tree with filters (same UI as `/export`)
- **Live updates** - New messages append without page refresh
- **Follow mode** - Auto-scrolls to latest message; pauses when you scroll up to read history
- **Share** - Create secret GitHub Gists directly from the browser
- **`/view` command** - Type `/view` inside pi to open the current session
## Install
Requires [Go](https://go.dev) 1.21+.
```bash
git clone https://github.com/ygncode/pi-sessions-viewer.git
cd pi-sessions-viewer
go build -o pi-sessions-viewer .
# Put on PATH
sudo cp pi-sessions-viewer /usr/local/bin/
# or
cp pi-sessions-viewer ~/.pi/agent/bin/
```
## Usage
```bash
# Start server (default port 27183)
pi-sessions-viewer
# Start and open browser
pi-sessions-viewer -o
# Custom port
pi-sessions-viewer -p 8080
```
Then open http://localhost:27183.
## Auto-start on login (macOS)
```bash
cp com.pi-sessions-viewer.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.pi-sessions-viewer.plist
```
The viewer starts automatically on boot and runs in the background.
## Pi integration
### `/view` command
Install the extension to add a `/view` command inside pi:
```bash
cp view-sessions.ts ~/.pi/agent/extensions/
```
Restart pi (or run `/reload`). Then type `/view` while in a session to open it in your browser.
### Skill
Install the skill so pi suggests the viewer when relevant:
```bash
cp -r skill ~/.pi/agent/skills/pi-sessions-viewer
```
## Sharing sessions
On any session page, click **Share** in the top-right to create a secret GitHub Gist.
Requirements:
- `gh` CLI installed (`brew install gh`)
- Logged in (`gh auth login`)
The share produces:
- A secret gist URL
- A preview URL at `https://pi.dev/session/#`
Shared gists are static snapshots and do not auto-update.
## How it works
Sessions are read from `~/.pi/agent/sessions/` as JSONL files. The server:
1. Parses each `.jsonl` session file
2. Generates HTML using pi's export templates (embedded in the binary)
3. Watches files for changes and pushes SSE events to the browser
4. The browser fetches new entries via `/api/session` and appends them incrementally
## License
MIT