Skip to content
agentsview
GitHub stars

Quick Start

Install

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

Windows:

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

The installer detects your OS and architecture, downloads the latest release from GitHub Releases, verifies the SHA-256 checksum, and installs the binary.

Verify the installation:

Terminal window
agentsview version

Build from source

Requires Go 1.25+ with CGO and Node.js 22+:

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

Run

Start the server:

Terminal window
agentsview

This will:

  1. Initialize the SQLite database at ~/.agentsview/sessions.db
  2. Discover and sync sessions from Claude Code, Codex, Copilot CLI, Gemini CLI, and OpenCode
  3. Start watching session directories for changes
  4. Launch the web UI at http://127.0.0.1:8080
  5. Open your browser automatically

Customize

Override the default port or host:

Terminal window
agentsview -port 9090
agentsview -host 0.0.0.0 -port 3000
agentsview -no-browser

Point to custom session directories with environment variables:

Terminal window
export CLAUDE_PROJECTS_DIR=~/custom/claude/projects
export CODEX_SESSIONS_DIR=~/custom/codex/sessions
export COPILOT_DIR=~/custom/copilot
export GEMINI_DIR=~/custom/gemini
export OPENCODE_DIR=~/custom/opencode
agentsview

What You’ll See

Once running, the web UI provides:

  • Session list with filtering by project, agent, date, and message count
  • Message viewer with full content, tool calls, and thinking blocks
  • Full-text search across all message content
  • Analytics including activity heatmaps, tool usage, and velocity charts
  • Session export to standalone HTML or GitHub Gist