agentsview

README

agentsview

A local web application for browsing, searching, and analyzing AI agent coding sessions. Supports Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Amp, and VSCode Copilot. 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, OpenCode, Amp, and VSCode Copilot
• 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, OpenCode, Amp, and VSCode Copilot, 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

Key	Action
Cmd+K	Open search
j / k	Next / previous message
] / [	Next / previous session
o	Toggle sort order
t	Toggle thinking blocks
e	Export session as HTML
p	Publish to GitHub Gist
r	Sync sessions
?	Show all 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 desktop-dev    # run Tauri desktop wrapper (experimental)
make test           # Go tests (CGO_ENABLED=1 -tags fts5)
make lint           # golangci-lint
make e2e            # Playwright E2E tests

Desktop Wrapper (Experimental)

A Tauri desktop wrapper is available under desktop/. It launches the existing agentsview Go binary as a local sidecar and loads http://127.0.0.1:<port> in a native webview.

make desktop-dev    # run desktop app in dev mode
make desktop-build  # build desktop bundles (.app/.exe/etc.)
make desktop-macos-app       # build macOS .app only
make desktop-windows-installer  # build Windows installer (.exe)

Friendly output copies are placed in:

• dist/desktop/macos/AgentsView.app
• dist/desktop/windows/*.exe

Desktop env escape hatch: ~/.agentsview/desktop.env (for PATH/API keys overrides).

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, Amp, VSCode Copilot)
internal/server/    HTTP handlers, SSE, middleware
internal/sync/      Sync engine, file watcher, discovery
frontend/           Svelte 5 SPA (Vite, TypeScript)

Supported Agents

Agent	Session Directory
Claude Code	~/.claude/projects/
Codex	~/.codex/sessions/
Copilot CLI	~/.copilot/session-state/
Gemini CLI	~/.gemini/
OpenCode	~/.local/share/opencode/
Amp	~/.local/share/amp/threads/
VSCode Copilot	~/Library/Application Support/Code/User/ (macOS)

Override with CLAUDE_PROJECTS_DIR, CODEX_SESSIONS_DIR, COPILOT_DIR, GEMINI_DIR, OPENCODE_DIR, AMP_DIR, or VSCODE_COPILOT_DIR environment variables.

Acknowledgements

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

License

MIT