Skip to content
agentsview
GitHub stars

Quick Start

Install

Desktop App

Download the latest .dmg (macOS), .exe (Windows), or .AppImage (Linux) from GitHub Releases. The desktop app is fully bundled — no CLI or dependencies needed — and includes built-in auto-update support.

Command Line

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

The desktop app handles startup automatically — just open the app. CLI users start the server manually:

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, Cursor, Gemini CLI, OpenCode, Amp, VS Code Copilot, OpenClaw, Pi, iFlow, and Zencoder
  3. Start watching session directories for changes
  4. Launch the web UI at http://127.0.0.1:8080

Open http://127.0.0.1:8080 in your browser, or pass -browser to open it automatically.

Customize

Override the default port or host:

Terminal window
agentsview -port 9090
agentsview -host 0.0.0.0 -port 3000
agentsview -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 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
export PI_DIR=~/custom/pi/sessions
export IFLOW_DIR=~/custom/iflow/projects
export ZENCODER_DIR=~/custom/zencoder/sessions
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