agentsview

agentsview

A local web application for browsing, searching, and analyzing AI agent coding sessions. Supports Claude Code, Codex, and Gemini CLI.

Why?

AI coding agents generate large volumes of session data across projects. agentsview indexes these sessions into a local SQLite database with full-text search, providing a web interface to find past conversations, review agent behavior, and track usage patterns over time.

Features

• Full-text search across all message content, instantly
• Analytics dashboard with activity heatmaps, tool usage, velocity metrics, and project breakdowns
• Multi-agent support for Claude Code, Codex, and Gemini CLI
• Live updates via SSE as active sessions receive new messages
• Keyboard-first navigation (vim-style j/k/[/])
• Export and publish sessions as HTML or to GitHub Gist
• Local-first -- all data stays on your machine, single binary, no accounts

Install

curl -fsSL https://agentsview.io/install.sh | bash

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"

The installer downloads the latest release, verifies the SHA-256 checksum, and installs the binary.

Build from source (requires Go 1.25+ with CGO and Node.js 22+):

git clone https://github.com/wesm/agentsview.git
cd agentsview
make build
make install  # installs to ~/.local/bin

Usage

agentsview              # start server, open browser
agentsview -port 9090   # custom port
agentsview -no-browser  # headless mode

On startup, agentsview discovers sessions from Claude Code, Codex, and Gemini CLI, syncs them into a local SQLite database with FTS5 full-text search, and opens a web UI at http://127.0.0.1:8080.

Screenshots

Dashboard	Session viewer

Search	Activity heatmap

Keyboard Shortcuts

Documentation

Full documentation is available at agentsview.io:

• Quick Start -- installation and first run
• Usage Guide -- dashboard, session browser, search, export
• CLI Reference -- commands, flags, and environment variables
• Configuration -- data directory, config file, session discovery
• Architecture -- how the sync engine, parsers, and server work

Development

make dev            # run Go server in dev mode
make frontend-dev   # run Vite dev server (use alongside make dev)
make test           # Go tests (CGO_ENABLED=1 -tags fts5)
make lint           # golangci-lint
make e2e            # Playwright E2E tests

Project Structure

cmd/agentsview/     CLI entrypoint
internal/config/    Configuration loading
internal/db/        SQLite operations (sessions, search, analytics)
internal/parser/    Session file parsers (Claude, Codex, Gemini)
internal/server/    HTTP handlers, SSE, middleware
internal/sync/      Sync engine, file watcher, discovery
frontend/           Svelte 5 SPA (Vite, TypeScript)

Supported Agents

Override with CLAUDE_PROJECTS_DIR, CODEX_SESSIONS_DIR, or GEMINI_DIR environment variables.

Acknowledgements

Inspired by claude-history-tool by Andy Fischer and claude-code-transcripts by Simon Willison.

License

MIT