📌 项目地址：kenn-io/agentsview | ⭐ 1,533 颗星 | 🔧 Go | 📜 未标注
一句话说清 agentsview 能做什么
如果你同时使用 Claude Code、Codex、Cursor、Windsurf、CodeGem 等多个 AI 编码辅助工具，会产生大量对话日志和费用记录。agentsview 是一个纯本地的二进制工具，能自动发现你机器上所有支持的智能体（超过 20 种）产生的会话文件，像日志浏览器一样展示、搜索、并统计每个智能体的使用成本。官方描述声称它比同类工具 ccusage 快 100 倍。
核心价值：数据永远在你口袋里
许多 AI 工具提供云端仪表板，但数据上传到别人服务器，且只能看各自平台的数据。agentsview 的设计哲学是 “Local-first”：
- 所有会话和成本数据存储在本地 SQLite 数据库中
- 不需要注册账户
- 一个二进制文件（Go 编译）即可运行，跨平台
- 可同时接入不同智能体的会话目录，在统一界面上检索
这解决了两个核心痛点：
– 多智能体数据分散：Claude Code 的日志在 ~/.claude/projects，Codex 在 ~/.codex，Cursor 另有位置…… agentsview 自动发现它们并合并展示。
– 成本不透明：智能体调用一次 API 花费多少模型调用费？agentsview 会计算并显示出 daily summary，让你清楚每天的 AI 助手使用成本。
快速上手：两条命令
根据 README，安装后只需要运行一条命令就能启动 Web UI：
agentsview serve # start server, open web UI
首次运行会自动扫描所有受支持的智能体会话，同步到本地 SQLite 数据库，然后在浏览器打开 http://127.0.0.1:8080。
如果你只想快速看成本摘要，可以运行：
agentsview usage daily # print daily cost summary
安装方式也很简单（macOS / Linux）：
curl -fsSL https://agentsview.io/install.sh | bash
Windows 用户用 PowerShell：
powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"
另外还提供桌面应用（macOS / Windows）和 Homebrew 安装：
brew install --cask agentsview
远程访问与安全注意事项
agentsview 默认只绑定到 loopback（127.0.0.1），并且验证请求的 Host 头以防止 DNS 重绑定攻击。如果你通过 SSH 端口转发、反向代理或远程开发环境（如 GitHub Codespaces、Coder、WSL2）访问，浏览器发送的 Host 可能不被服务器识别，导致 API 返回 403 Forbidden。解决办法：使用 --public-url 指定浏览器中访问的完整地址。
# SSH 本地转发场景
agentsview serve --public-url http://127.0.0.1:18080
# 远程开发环境场景
agentsview serve --public-url https://your-workspace.exe.dev
如果需要允许额外来源，可以用 --public-origin 可重复或逗号分隔。如果要将 UI 暴露到本地回环之外，务必启用 --require-auth 增加认证。
Docker 部署：适合隔离环境
项目提供了 Docker 镜像和 docker-compose.prod.yaml 用于生产部署。运行镜像时需要显式挂载智能体会话目录，因为容器内无法自动发现宿主机上的路径。示例命令：
docker run --rm -p 127.0.0.1:8080:8080
-v agentsview-data:/data
-v "$HOME/.claude/projects:/agents/claude:ro"
-v "$HOME/.forge:/agents/forge:ro"
-e CLAUDE_PROJECTS_DIR=/agents/claude
-e FORGE_DIR=/agents/forge
ghcr.io/kenn-io/agentsview:latest
注意：只挂载你需要的智能体目录，未挂载的目录容器内无法发现。另外建议使用 named volume（agentsview-data:/data）而不是 bind mount 以避免 root 用户写入宿主目录的权限问题。
使用 docker-compose.prod.yaml：
docker compose -f docker-compose.prod.yaml up -d
Compose 文件中自动挂载了 Claude、Codex、Forge、OpenCode 的会话目录（只读），并持久化数据卷。
和同类工具的对比
官方明确提到它是 “100x faster replacement for ccsage”，ccusage 是一个同样用于 Claude Code 使用统计的 CLI 工具，但只支持 Claude Code。agentsview 则覆盖 20+ 智能体，且是图形界面 + CLI 双模式，性能对标。虽然没有给出具体基准，但 Go 语言编译的单二进制在扫描大量日志文件时通常比 Python 脚本快得多。
适合谁用？
- 重度 AI 编码用户：日常使用多个智能体，需要统一回顾对话、查开销。
- 个人开发者/小团队：希望本地保存敏感对话历史，不依赖云服务。
- Docker/远程开发环境用户：将 agentsview 部署在容器内或 Codespace 中，通过 SSH 转发访问，保持环境干净。
- 成本敏感者：定期查看 daily summary，控制每月 AI 调用预算。
不适合的场景：如果你只用一个智能体且不需要历史检索，或者你完全信任云平台的成本分析，则此工具价值有限。
局限性
- 仅支持列表中的 20+ 智能体，未列出的可能无法自动发现。
- 容器部署需要显式挂载目录，自动化程度不如直接宿主机运行。
- 远程访问需要额外配置
--public-url和--require-auth，增加心智负担。 - 项目目前 Star 数 1533，社区较小，文档和 issue 可能不足以覆盖所有边缘情况。