Quick Start

Install

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

Windows:

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:

agentsview version

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

Note

CGO is required for the SQLite driver. The fts5 build tag enables full-text search.

Run

Start the server:

agentsview

This will:

1. Initialize the SQLite database at ~/.agentsview/sessions.db
2. Discover and sync sessions from Claude Code, Codex, Copilot CLI, Cursor, Gemini CLI, OpenCode, Amp, VS Code Copilot, and OpenClaw
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:

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

Point to custom session directories with environment variables:

export CLAUDE_PROJECTS_DIR=~/custom/claude/projects
export CODEX_SESSIONS_DIR=~/custom/codex/sessions
export COPILOT_DIR=~/custom/copilot
export CURSOR_PROJECTS_DIR=~/custom/cursor/projects
export GEMINI_DIR=~/custom/gemini
export OPENCODE_DIR=~/custom/opencode
export AMP_DIR=~/custom/amp/threads
export VSCODE_COPILOT_DIR=~/custom/vscode
export OPENCLAW_DIR=~/custom/openclaw/agents
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