Archived Agent Session Viewer

Agent Session Viewer

**This project has been superseded by [AgentsView](https://github.com/wesm/agentsview) ([agentsview.io](https://agentsview.io)) and is no longer maintained.** Please use AgentsView instead.

---

Browse, search, and revisit your AI coding sessions. Never lose track of that clever solution your AI pair programmer came up with three weeks ago.


Why?

AI coding sessions pile up fast. Finding that one conversation where you solved a tricky bug or implemented a specific pattern means digging through session files by hand. This tool gives you instant full-text search across every session from Claude Code and Codex, organized by project.

Features

• Full-text search - Find any message across all your sessions instantly
• Live updates - Active sessions refresh automatically as new messages arrive
• Auto-sync - Background sync every 15 minutes, plus manual sync with r
• Keyboard-first - Vim-style navigation (j/k/[/]) for fast browsing
• Project organization - Sessions grouped by codebase
• Export & publish - Download sessions as HTML or publish to GitHub Gist for sharing
• Local-first - All data stays on your machine in ~/.agent-session-viewer/
• Zero config - Works out of the box

Install

# With uv (recommended)
uv tool install agent-session-viewer

# With pip
pip install agent-session-viewer

Usage

# If installed via uv tool install or pip
agent-session-viewer

# Or run directly without installing
uvx agent-session-viewer@latest

Opens a browser at `http://localhost:8080`.

Options:

• --port 9000 - Use a custom port
• --no-browser - Don't open browser automatically
• --host 0.0.0.0 - Bind to all interfaces

Keyboard Shortcuts

Key	Action
j / k	Next / previous message
] / [	Next / previous session
o