agentsview

agentsview

A local web application for browsing, searching, and analyzing AI agent coding sessions. Supports Claude Code, Codex, Copilot CLI, Gemini CLI, and OpenCode. A next-generation rewrite of agent-session-viewer in Go.

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

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, Copilot CLI, Gemini CLI, and OpenCode
• 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

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, Copilot CLI, Gemini CLI, and OpenCode, 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 parsers (Claude, Codex, Copilot, Gemini, OpenCode)
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, COPILOT_DIR, GEMINI_DIR, or OPENCODE_DIR environment variables.

Acknowledgements

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

License

MIT