🔍 Agent Log Viewer

Universal AI agent conversation viewer. Right-click any folder to explore.

English · 中文文档 · Report Bug · Request Feature

---

🎯 What Is This?

Agent Log Viewer is a universal conversation history viewer for AI coding agents. Currently supports Claude Code, with more agents coming soon.

It integrates directly into Windows Explorer — right-click any folder, select "View Agent Log", and your conversation history opens in a beautifully rendered ChatGPT-style interface.

🔮 Roadmap: Support for Cursor, Copilot, Windsurf, Aider, and other AI coding agents is planned. See Supported Agents for details.

✨ Features

🖱️ Right-Click to View Just right-click any folder in Windows Explorer and select "View Agent Log". Your conversation history opens in the browser instantly.	🎯 Smart Project Detection Automatically matches the clicked folder to its agent project data. Non-agent folders get a friendly notice with a list of known projects.
💬 ChatGPT-Style UI Beautiful dark/light theme with conversation bubbles, markdown rendering, syntax-highlighted code blocks, and a collapsible sidebar.	🔗 Multi-Session Timeline All sessions from the same project are merged into a single chronological timeline, with clear session dividers and timestamps.
📦 Export Anywhere Export conversations to Markdown (.md), Plain Text (.txt), or Word Document (.doc) with one click.	🌗 Dark / Light Theme Toggle between dark and light themes. Your preference is remembered across sessions.

More Goodies

Feature	Description
🔀 Consecutive Message Merge	Same-role messages are grouped into one bubble with dashed separators
🔍 Search	Filter sessions in the sidebar by keyword
📋 Copy Code	Hover any code block to reveal a one-click copy button
🧹 Auto Cleanup	Temp HTML files older than 1 hour are automatically removed
🔐 No Admin Required	Uses HKCU registry keys — no UAC prompt

---

🤖 Supported Agents

Agent	Status	Data Source
	✅ Fully Supported	~/.claude/projects/<path>/<session>.jsonl
	🔮 Planned	Workbench session storage
	🔮 Planned	VS Code chat history
	🔮 Planned	Cascade session data
	🔮 Planned	.aider.chat.history.md

Want to add support for another agent? Open an issue or submit a PR!

---

🚀 Quick Start

Install (takes 5 seconds)

git clone https://github.com/<your-username>/agent-log-viewer.git
cd agent-log-viewer

Then double-click register.bat ✅

That's it. You'll now see "View Agent Log" in your right-click context menu.

Uninstall

Double-click unregister.bat 🧹

---

📖 How It Works

┌─────────────────────────────────────────────────────────┐
│                    Windows Explorer                      │
│                                                         │
│   Right-click any folder ──────► "View Agent Log"       │
│                                                         │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│                    launcher.bat                          │
│                                                         │
│   Receives folder path (%V or %1)                       │
│   Calls PowerShell with the path                        │
│                                                         │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│                   generate.ps1                           │
│                                                         │
│   1. Encode path → find matching project folder         │
│      in ~/.claude/projects/                             │
│   2. Fallback: scan JSONL cwd fields                    │
│   3. Read all .jsonl session files                      │
│   4. Extract user text + assistant text blocks          │
│   5. Filter out tool_calls, thinking, attachments       │
│   6. Sort by timestamp + line index                     │
│   7. Inject data into viewer.html template              │
│   8. Open in default browser                            │
│                                                         │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│              Browser (viewer.html)                       │
│                                                         │
│   ┌──────────┐  ┌──────────────────────────────────┐   │
│   │ Sidebar   │  │  Chat Messages                    │   │
│   │           │  │                                   │   │
│   │ Session 1 │  │  🟦 User: "Help me build..."     │   │
│   │ Session 2 │  │  🟩 Assistant: "Sure! Let's..."  │   │
│   │ Session 3 │  │  🟩 ... (merged)                  │   │
│   │           │  │  ─── Session Divider ───          │   │
│   │ 🔍 Search │  │  🟦 User: "Now add..."            │   │
│   │           │  │  🟩 Assistant: "Done! ..."        │   │
│   └──────────┘  └──────────────────────────────────┘   │
│                                                         │
│   [☀/☾ Theme] [Export ▾]                                │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

📁 Project Structure

agent-log-viewer/
│
├── 📄 viewer.html        → ChatGPT-style UI template (CSS + JS)
├── ⚙️ generate.ps1       → Core: JSONL parsing, data extraction, HTML generation
├── 🖱️ launcher.bat       → Context menu entry point (receives folder path)
├── 📥 register.bat       → Install right-click menu (HKCU, no admin needed)
├── 🗑️ unregister.bat     → Remove right-click menu
├── 📋 .gitignore
├── 📖 README.md          → English
└── 📖 README_CN.md       → 中文文档

---

🛠️ Technical Details

Registry Integration

Key	Scope	Trigger
HKCU\Software\Classes\Directory\shell\AgentLogViewer	Per-user, no admin	Right-click on folder icon
HKCU\Software\Classes\Directory\Background\shell\AgentLogViewer	Per-user, no admin	Right-click in folder background

Data Source (Claude Code)

Claude Code stores conversation data as JSONL files in:

~/.claude/projects/<encoded-project-path>/<session-uuid>.jsonl

Each line is a JSON object. Agent Log Viewer extracts:

JSONL type	Extracted Content
"user" with string message.content	User's text messages
"assistant" with content[].type === "text"	Assistant's text responses

Filtered out: thinking, tool_use, tool_result, attachment, permission-mode, etc.

Message Ordering

Messages are sorted by a dual-key scheme:

1. Primary: ISO 8601 timestamp (string comparison — naturally ordered)
2. Secondary: Line index within the JSONL file (stable tiebreaker)

This ensures strictly chronological order even when multiple entries share the same millisecond timestamp.

Temp File Management

Generated HTML files are stored in %TEMP%\agent_log_*.html. On each launch, files older than 1 hour are automatically purged.

---

⚙️ Requirements

Requirement	Details
	Built-in PowerShell 5.1+ required
	For proper CSS custom properties & marked.js
	At least one project with conversation history

Note: No Python, Node.js, or any runtime installation needed. Everything runs on Windows built-in tools.

---

🗺️ Roadmap

• Cursor support — Parse Cursor's workbench session storage
• Copilot support — Read VS Code GitHub Copilot chat history
• Windsurf support — Parse Cascade session data
• Aider support — Read .aider.chat.history.md
• Multi-agent view — Show conversations from multiple agents in the same project
• Cross-platform — macOS and Linux support
• Search full-text — Search within message content, not just session metadata

---

🤝 Contributing

Contributions are welcome! Especially agent adapters for new AI coding tools.

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
3. 💾 Commit your changes (git commit -m 'Add amazing feature')
4. 📤 Push to the branch (git push origin feature/amazing-feature)
5. 🔄 Open a Pull Request

---

📝 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Made with ❤️ for the AI coding agent community

⬆ Back to Top