agentsview

last_edited: 2026-10-09

Browse, search, and track costs across your AI coding agents. Your session archive stays on your machine unless you choose a feature that shares it.

This README and the documentation (opens in a new tab) follow main. The latest release is v0.45.0. Check the changelog (opens in a new tab) for what it includes.

Version 0.45.0 adds Spanish, Junie/OMO/StepCode sessions, message-frequency charts, and conversation-memory plugins for Claude Code and Codex. Review tool errors and recovery in the transcript, approve extracted Recall entries, and compare prompt volume including cache reads and writes.

Remote / forwarded access

agentsview binds to loopback and validates the request Host header to guard against DNS-rebinding attacks. When you reach it through SSH port-forwarding, a reverse proxy, or a remote dev environment (exe.dev, Codespaces, Coder, WSL2), the browser sends a Host that the server does not recognize, so API requests such as /api/v1/settings are rejected with 403 Forbidden.

To fix this, restart the server with --public-url set to the exact origin you open in the browser:

--public-url also selects the URL opened on startup; it does not configure a listener or external proxy. Use --no-browser on a headless server, or use --public-origin (repeatable or comma-separated) on its own for trust-only configuration. If you expose the UI beyond loopback, also enable --require-auth. See for the listener, browser URL, and managed Caddy port rules.

Token Usage and Cost Tracking

agentsview usage tracks token consumption and compute costs across all your coding agents -- not just Claude Code. Reports read from the same local SQLite archive that powers the UI.

Features:

• Automatic pricing via LiteLLM and OpenRouter rates (with offline fallback)
• Authoritative Copilot CLI billing totals when session logs provide them
• Prompt-caching-aware cost calculation (cache creation / read tokens)
• Per-model breakdown with --breakdown
• Date filtering (--since, --until, --all), agent filtering (--agent)
• JSON output (--json) for scripting
• Timezone-aware date bucketing (--timezone)
• Works standalone -- no server required, just run the command

Per-Session Details

agentsview session usage prints per-session token statistics plus a cost estimate for a single session. The output reports the session's total output tokens and peak context tokens, plus a cost estimate (cost) when pricing is available for the session's model(s) (has_cost). Cost is computed from