A web viewer for AI agent coding sessions (Claude Code, Codex, etc.)
Project description
Agent Session Viewer
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
- 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
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 |
Toggle message order |
r |
Sync sessions |
⌘K |
Focus search |
? |
Show all shortcuts |
Supported Agents
- Claude Code - syncs from
~/.claude/projects/ - Codex - syncs from
~/.codex/sessions/
How It Works
The viewer syncs sessions from each agent's local storage into its own database with full-text search indexing. When you're viewing an active session, it watches the source file and updates the UI within seconds of new messages.
Acknowledgements
Inspired by claude-history-tool by Andy Fischer and claude-code-transcripts by Simon Willison.
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_session_viewer-0.2.0.tar.gz.
File metadata
- Download URL: agent_session_viewer-0.2.0.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db49e057300e7b16da23f25331c962ac896eacd470c67109845721a82268448b
|
|
| MD5 |
d83b0467aa7a317569f1502b64a022cb
|
|
| BLAKE2b-256 |
8fe03dea880f60eff66553947a19e09068355a573141ac9817c83c83bfa234f0
|
File details
Details for the file agent_session_viewer-0.2.0-py3-none-any.whl.
File metadata
- Download URL: agent_session_viewer-0.2.0-py3-none-any.whl
- Upload date:
- Size: 1.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4edb7be7bbd0340fdae19389d87409076dbff3fa5b256cd4b77aeac098924a73
|
|
| MD5 |
5048ce8fac9a7ba91207d37127217106
|
|
| BLAKE2b-256 |
0b56ba84109c4a6aac2d90dd825e33771838307955bf6a20df99e9f0cf9e3d24
|
