用途
agentsview 是一款本地优先（local-first）的工具，用于浏览、搜索和追踪 20 多种 AI 编程智能体的会话与成本，覆盖 Claude Code、Codex、Cursor、Copilot 等。所有处理均在本地完成，无需账号或云依赖。它使用 Go 编写，以 SQLite 作为存储，并提供 Web UI 用于会话浏览、全文搜索、Token 用量分析和成本追踪。
主要能力
- 会话浏览与全文搜索（基于 FTS5）。
- Token 用量分析：按日、按模型、按智能体、按日期范围统计。
- 成本追踪：每日成本汇总、按模型细分、单会话用量查询。
- 会话统计：人类可读统计与 JSON 输出，可选包含 git 指标与 GitHub PR 指标。
- 数据库操作：将智能体会话同步进 SQLite，可导出到 DuckDB，支持 PostgreSQL 模式。
- REST API：提供会话用量、设置、搜索等接口。
- 远程访问支持：SSH 端口转发、反向代理、远程开发环境。
- 后台服务：支持后台运行、状态查询、停止，以及 systemd 用户服务。
使用方式
安装
macOS / Linux：
curl -fsSL https://agentsview.io/install.sh | bash
Windows：
powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"
Homebrew（macOS）：
brew install --cask agentsview
Docker：
docker run --rm -p 127.0.0.1:8080:8080 \
-v agentsview-data:/data \
-v "$HOME/.claude/projects:/agents/claude:ro" \
-v "$HOME/.codex/sessions:/agents/codex:ro" \
-e CLAUDE_PROJECTS_DIR=/agents/claude \
-e CODEX_DIR=/agents/codex \
ghcr.io/kenn-io/agentsview:latest
从源码构建：
git clone https://github.com/kenn-io/agentsview.git
cd agentsview
go build -o agentsview ./cmd/agentsview
./agentsview serve
核心命令
服务器管理：
agentsview serve
agentsview serve --background
agentsview serve status
agentsview serve stop
agentsview serve --port 9090
agentsview serve --require-auth
Token 用量与成本追踪：
agentsview usage daily
agentsview usage daily --breakdown
agentsview usage daily --agent claude --since 2026-04-01 --until 2026-04-30
agentsview usage daily --all
agentsview usage daily --all --json
agentsview usage statusline
agentsview session usage <session-id>
agentsview session usage <session-id> --format json
会话分析：
agentsview stats
agentsview stats --format json --since 2026-04-01 --until 2026-04-15
agentsview stats --agent claude
agentsview stats --include-git-outcomes
agentsview stats --include-github-outcomes
数据库操作：
agentsview sync
agentsview duckdb push --full
agentsview duckdb serve
agentsview pg serve
配置
环境变量：
export CLAUDE_PROJECTS_DIR="$HOME/.claude/projects"
export CODEX_DIR="$HOME/.codex/sessions"
export CURSOR_DIR="$HOME/.cursor/sessions"
export FORGE_DIR="$HOME/.forge"
export COPILOT_DIR="$HOME/.copilot"
export AGENTSVIEW_DATA_DIR="$HOME/.agentsview"
export AGENTSVIEW_PG_URL="postgres://user:pass@host:5432/agentsview?sslmode=require"
export AGENTSVIEW_DUCKDB_URL="quack:https://duckdb.example.com"
export AGENTSVIEW_DUCKDB_TOKEN="your-quack-token"
export AGENTSVIEW_PORT="8080"
export AGENTSVIEW_PUBLIC_URL="http://127.0.0.1:8080"
远程访问
agentsview serve --public-url http://127.0.0.1:18080
agentsview serve --public-url https://your-workspace.exe.dev
agentsview serve --public-origin https://dev.example.com,https://staging.example.com
REST API
curl http://127.0.0.1:8080/api/v1/sessions/<session-id>/usage
curl http://127.0.0.1:8080/api/v1/settings
curl "http://127.0.0.1:8080/api/v1/search?q=refactor+authentication"
支持的智能体与默认会话路径
- Claude Code：
~/.claude/projects/ - Codex：
~/.codex/sessions/ - Cursor：
~/.cursor/sessions/ - Copilot CLI：
~/.copilot/ - Forge：
~/.forge/ - Amp：
~/.local/share/amp/threads/ - Claude Cowork：
~/Library/Application Support/Claude/local-agent-mode-sessions/（macOS） - Antigravity：
~/.gemini/antigravity/ - Cortex Code：
~/.snowflake/cortex/conversations/
所有路径均自动检测，可用环境变量覆盖。
适用场景
- 在本地查看和搜索多个 AI 编程智能体的历史会话。
- 追踪每日、按模型或按智能体的 Token 用量与成本。
- 在 shell 提示符中显示当日 AI 智能体成本。
- 生成自动化每日报告，或在 CI/CD 中追踪智能体成本。
- 直接查询 SQLite 数据库，或通过 REST API 以编程方式导出会话数据。
- 通过 Docker Compose、systemd 或 PostgreSQL/DuckDB 后端进行生产化部署。
限制
- 成本数据依赖 LiteLLM 数据库中的模型定价；若模型无定价或未记录 Token 数据，则
has_cost为 false 或cost_usd为 0。 --include-git-outcomes在大仓库或缺少 git 历史时可能较慢或挂起。- 非回环地址访问需启用认证（
--require-auth）。 - 通过 SSH 隧道、反向代理或远程开发环境访问时，若 Host 头校验失败会返回 403，需要设置
--public-url或--public-origin。 - Docker 使用绑定挂载可能产生 root 属主文件，建议使用命名卷。
- 其他未在资料中说明的功能、收费、价格、平台或效果暂未提供。