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.

pip / uvx

Terminal window
pip install agentsview    # install permanently
uvx agentsview            # or run without installing

Platform-specific wheels are published to PyPI for Linux (x86_64, aarch64), macOS (x86_64, arm64), and Windows (x86_64).

Shell Script

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.

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 all supported agents
  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
export KIMI_DIR=~/custom/kimi/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