agentsview

module
v0.12.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 11, 2026 License: MIT

README

agentsview

A local-first desktop and web application for browsing, searching, and analyzing AI agent coding sessions. Supports Claude Code, Codex, OpenCode, and 8 other agents.

Analytics dashboard

Desktop App

Download the desktop installer for macOS or Windows from GitHub Releases. The desktop app includes auto-updates and runs the server as a local sidecar -- no terminal required.

CLI Install

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

Windows:

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

The CLI 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, OpenCode, and 8 other agents (full list)
  • 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 all supported agents, 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
Dashboard Session viewer
Search Activity heatmap
Search 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:

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 app in dev mode
make test           # Go tests (CGO_ENABLED=1 -tags fts5)
make lint           # golangci-lint
make e2e            # Playwright E2E tests

Desktop Development

The desktop app is a Tauri wrapper under desktop/. It launches the 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)
make desktop-macos-app           # build macOS .app only
make desktop-windows-installer   # build Windows installer (.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 (all supported agents)
internal/server/    HTTP handlers, SSE, middleware
internal/sync/      Sync engine, file watcher, discovery
frontend/           Svelte 5 SPA (Vite, TypeScript)

Supported Agents

Agent Session Directory Env Override
Claude Code ~/.claude/projects/ CLAUDE_PROJECTS_DIR
Codex ~/.codex/sessions/ CODEX_SESSIONS_DIR
Copilot ~/.copilot/ COPILOT_DIR
Gemini ~/.gemini/ GEMINI_DIR
OpenCode ~/.local/share/opencode/ OPENCODE_DIR
Cursor ~/.cursor/projects/ CURSOR_PROJECTS_DIR
Amp ~/.local/share/amp/threads/ AMP_DIR
iFlow ~/.iflow/projects/ IFLOW_DIR
VSCode Copilot ~/Library/Application Support/Code/User/ (macOS) VSCODE_COPILOT_DIR
Pi ~/.pi/agent/sessions/ PI_DIR
OpenClaw ~/.openclaw/agents/ OPENCLAW_DIR

Acknowledgements

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

License

MIT

Directories

Path Synopsis
cmd
agentsview command
ABOUTME: CLI subcommand that syncs session data into the database ABOUTME: without starting the HTTP server.
ABOUTME: CLI subcommand that syncs session data into the database ABOUTME: without starting the HTTP server.
testfixture command
internal
db
dbtest
Package dbtest provides shared test helpers for database setup and session seeding across test packages.
Package dbtest provides shared test helpers for database setup and session seeding across test packages.
parser
ABOUTME: Parses Claude Code JSONL session files into structured session data.
ABOUTME: Parses Claude Code JSONL session files into structured session data.
testjsonl
Package testjsonl provides shared JSONL fixture builders for Claude and Codex session test data.
Package testjsonl provides shared JSONL fixture builders for Claude and Codex session test data.
web

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL