Claude Sessions Viewer

A lightweight web dashboard to browse and search your Claude Code session history. Zero dependencies, single-command install.

Features

• Auto-scans ~/.claude/ to discover all session history
• Timeline view grouped by date
• Filter by project, search across messages
• One-click "resume" command for any session
• Browser-based rescan button (no restart needed)
• Works on any server with Claude Code installed
• Single HTML file, no build step, no JS frameworks
• Auto-starts on reboot via crontab

Quick Install

git clone https://github.com/olimpuss/claude-sessions-viewer.git ~/claude-sessions
bash ~/claude-sessions/install.sh

Custom port:

bash ~/claude-sessions/install.sh 9090

That's it. Open http://<your-ip>:8089 in your browser.

How It Works

~/.claude/history.jsonl  -->  scanner.py  -->  sessions-data.json  -->  index.html
       (Claude Code)          (extracts)        (JSON data)            (web UI)

1. scanner.py reads Claude Code's history.jsonl, groups messages by session ID, extracts project paths, timestamps, and message previews
2. serve.py serves the static files and exposes a /rescan endpoint
3. index.html loads sessions-data.json and renders the timeline UI

Manual Usage

Scan sessions:

python3 scanner.py

Start server:

python3 serve.py
# or with custom port:
CLAUDE_SESSIONS_PORT=9090 python3 serve.py

Files

File	Description
index.html	Web UI - single file, zero dependencies
scanner.py	Session scanner - reads ~/.claude/ history
serve.py	HTTP server with /rescan endpoint
install.sh	One-command installer

Requirements

• Python 3.8+
• Claude Code installed (~/.claude/ directory)

License

MIT