查遍 50+ AI 编码代理的历史与花费：AgentsView 完整上手指南
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
月底想弄清楚 AI 编程工具到底花了多少钱？AgentsView 是一个本地优先（local-first）的开源工具，把 Claude Code、Codex、Cursor 等 50+ 款编码代理（coding agent）的会话历史统一归档，支持全文与语义搜索、token 用量统计和成本分析，数据全部留在本机，适合用多个 AI 代理的开发者。
🚀 三条命令跑起来
安装方式任选其一：
# macOS / Linux：一键脚本 curl -fsSL https://agentsview.io/install.sh | bash # macOS：Homebrew brew install --cask agentsview # 全平台 wheel pip install agentsview然后执行首次运行命令：
agentsview serve # 前台启动；daemon start 可切后台启动后浏览器会打开http://127.0.0.1:8080：它自动发现本机各代理的会话目录，解析进本地 SQLite，你能看到按项目、代理、日期过滤的会话列表，以及完整的消息、思考块（thinking，模型推理过程）和工具调用。会话正在进行时，新消息通过 SSE（服务端事件推送）实时进入界面。
💸 它能帮你解决什么
钱花哪儿了？
agentsview usage daily --breakdown # 近 30 天每日成本，按模型拆分 agentsview session usage <id> # 单个会话的 token 与成本估算报表直接读预建索引的本地数据库，无需重新解析原始文件，查询响应很快；定价自动采用 LiteLLM / OpenRouter 费率并带离线回退，还区分缓存创建与缓存读取 token，避免重复计费。也可以把agentsview usage statusline的一行摘要嵌进终端状态栏。
上个月的报错当时怎么解决的？
agentsview session search "panic: nil pointer"全文搜索基于 SQLite 的 FTS5 索引（虚拟表全文索引），覆盖所有消息正文；Web 端按Ctrl/Cmd+K打开命令面板，还能按项目和日期过滤。关键词对不上时，开启语义搜索——agentsview session search --semantic（或--hybrid）通过 OpenAI 兼容的 embedding（向量化）端点按"意思"匹配，每条结果都标注出处对话片段，支持中日韩文本切分。
哪些文件最近被改过？
Web 界面顶栏的Recent Edits（直达/recent-edits）把所有会话里Edit/Write工具调用改过的文件按"项目 + 路径"聚合成信息流；展开某个文件能看到每次编辑，点一下直接跳到做出改动的那条消息。想知道"谁改了什么"，不用再翻会话记录。
代理什么时候在并行干活？
agentsview activity report --preset week --json把带时间戳的会话数据聚合成时间视图：峰值并发时刻、活跃/空闲时长、代理分钟数（agent-minutes）和总成本，范围可选天/周/月/自定义，也能按项目、代理、机器过滤；Web 端对应的 Activity 页面还有并发堆叠图与消息频率视图。
让 AI 助手直接查你的历史
agentsview mcp # 启动只读 MCP 服务器MCP（Model Context Protocol，一种让 AI 助手调用外部工具的开放协议）客户端接上后，能回答"这个错以前解决过吗""总结这个项目的近期 token 用量"这类问题。服务器提供 15 个只读工具，包括search_sessions、get_messages、search_content、get_usage_summary、get_recent_edits、compare_usage等，均不修改档案。
🔍 数据链路：从各代理目录到本地数据库
数据流向很直接：AgentsView 自动发现本机各代理的会话目录（如 Claude Code 的~/.claude/projects/、Codex 的~/.codex/sessions/），解析 JSONL / SQLite 等格式后写入~/.agentsview/sessions.db；文件监听捕获新消息实时同步，Web 界面与 CLI 都从这份档案读取。存储后端按需扩展：
| 后端 | 定位 |
|---|---|
| SQLite | 主本地档案：文件同步、FTS5 搜索、可写界面 |
| PostgreSQL | 可选团队共享：pg push推送、pg serve只读服务，支持--watch自动推送 |
| DuckDB | 可选分析镜像：duckdb push生成便携文件，可经 Quack 协议远程只读访问 |
| ClickHouse | 可选远程分析后端：clickhouse push推送、clickhouse serve只读查询 |
兼容范围：50 多个代理零配置发现，包括 Claude Code、Codex、Copilot CLI、Cursor、Windsurf、Trae、Kimi、Qwen Code、Gemini CLI、OpenCode、Aider（需设置AIDER_DIR启用）等，完整清单见 README 的 Supported Agents 表和 配置文档 的 Session Discovery 章节。隐私边界明确：会话数据全部留在本机，服务端默认只绑定127.0.0.1；对外仅发一条不含会话/项目/文件路径的匿名遥测，设AGENTSVIEW_TELEMETRY_ENABLED=0即可关闭，更新检查也可用--no-update-check禁用。桌面版（Tauri 打包，macOS/Windows/Linux）与 CLI 共享同一数据目录，可混用。
📚 深入学习
- 快速上手：安装、首次运行、自定义会话目录与环境变量
- CLI 命令参考：全部命令与参数，含
usage、session、stats系列 - Token 用量与成本：各代理的用量覆盖范围、缓存感知计费与自定义定价
- Activity 报告：并发、代理分钟数与成本归口的计算规则
- MCP 服务器：客户端配置、15 个工具清单与记忆档案（memory profile）用法
- 语义搜索：embedding 端点配置与
--semantic/--hybrid行为细节
AgentsView 的定位就是"一份本地会话档案"：把散落在各家代理目录里的对话、花费和质量信号统一起来，默认不出内网，需要共享时再按自己的节奏同步出去。
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
