AgentsView:AI代理会话分析,把旧对话、成本与活跃度查得明明白白
【免费下载链接】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,数据不出本机)的 AI 代理会话分析工具:用一个二进制把 50+ 编码代理散落在各处的会话收进同一个本地档案,旧对话检索、token 成本核算、活跃度复盘都能秒查,不需要账号,默认只绑定回环地址。
项目定位
AgentsView 面向同时使用 Claude Code、Codex、Cursor 等两个以上编码代理的开发者,定位是多代理工作流下的统一档案与分析层。它把三件事管住:历史可检索、成本可核算、活动可复盘。两个关键数字:官方收录的代理会话目录清单覆盖 50+ 款代理(完整条目见 README.md 的 Supported Agents 表格);在 2.2 万会话规模的档案上,agentsview usage类查询比每次重新解析原始文件的同类工具快 80–220 倍。前端是 Svelte 5 单页应用,直接嵌入 Go 二进制,无额外运行时依赖。
工作原理
- 扫描本机目录,自动定位各受支持代理的会话目录(零配置,Aider 需设置
AIDER_DIR启用) - 解析 JSONL、SQLite 等会话文件,写入本地 SQLite 并建立 FTS5 全文索引
- 在
http://127.0.0.1:8080提供 Web 界面与 API - 文件监听器捕获进行中会话的新消息,经 SSE 实时推送到浏览器
- 同一份档案可按需只读推送到 PostgreSQL / ClickHouse / DuckDB,或经
session_sources汇入其他机器的会话目录
功能按场景拆解
🔍 历史对话怎么秒找
痛点:你记得结论,却想不起它在哪个代理、哪一天的会话里。
- 对全部消息内容建 FTS5 全文索引,覆盖用户输入、助手回复、思考块与工具调用
- 支持中日韩文本:CJK 字符与短语匹配,中文走
simple/cppjieba 分词 - 语义搜索可选开启:接入任意 OpenAI 兼容的 embeddings 端点,按"意思"检索,每条结果标注来源对话片段
- 键盘优先导航:
j/k切换、Ctrl/Cmd+K全局搜索、?查看全部快捷键;活跃会话经 SSE 实时刷新 - Recent Edits 信息流按项目和路径聚合各代理最近修改的文件,每次编辑可跳转回做出改动的那条消息
agentsview session search "context loss retry" agentsview session search "构建死锁" --semantic💰 每日 token 成本一行命令算清
痛点:多个代理的花费散在各自计费面板,没有一个总数。
- 从本地预建索引直接出账,无需重扫源文件,2.2 万会话实测快 80–220 倍
- 自动套用 LiteLLM / OpenRouter 定价(含离线回退),提示缓存感知计价,缓存写入/读取分开核算
--breakdown按模型拆分,--agent、--since、--until过滤,statusline输出一行摘要供 shell 状态栏使用- 单个会话用
agentsview session usage <id>查看其输出 token、峰值上下文与成本估算
agentsview usage daily agentsview usage daily --breakdown agentsview usage statusline📊 看清代理何时在忙、花了多少
痛点:多个代理整天并行,谁在干活、忙到什么程度、花了多少钱,全靠猜。
- Activity 报告给出峰值并发时刻、活跃/空闲时长、agent-minutes(并发代理的工作分钟合计)与总成本
- 时间范围支持天/周/月/自定义区间,可按项目、代理、机器过滤,结果可写入 URL 参数分享
agentsview stats输出窗口统计:会话原型分布(快问快答/标准/深度/马拉松)、时长分布、工具-轮次比、缓存经济学与确定性质量信号- Web 端对应 Activity 页面:并发堆叠柱状图、消息频率、成本趋势
agentsview activity report --preset week --json🔌 让 AI 助手用 MCP 查你的历史
痛点:在新会话里想问"这个错以前解决过吗",却只能自己翻。
agentsview mcp启动一个只读 MCP 服务器,工具不会修改档案- 暴露
search_sessions、list_sessions、get_session_overview、get_messages、search_content、get_usage_summary等只读工具,助手在对话中直接检索历史 - 配
--profile memory精简档案,只暴露记忆相关工具;Recall 语料浏览器可审阅蒸馏出的知识条目并跳回支撑证据,Generated Insights 则按显式会话范围让模型撰写分析报告
agentsview mcp兼容与生态
支持对象(节选,完整 50+ 款见 README.md 表格):
| 类别 | 覆盖代理 |
|---|---|
| 主流 CLI | Claude Code、Codex、Gemini CLI、Copilot CLI、Grok、Zed、Warp |
| 编辑器/IDE | Cursor、VS Code Copilot、Visual Studio Copilot、Windsurf、Trae、RooCode、Kiro |
| 国产及其他 | Qwen Code、QwenPaw、Kimi、iFlow、DeepSeek TUI、Qoder、OpenCode、OpenHands、WorkBuddy 等 |
存储后端与扩展:
| 后端 | 定位 | 常用命令 |
|---|---|---|
| SQLite | 主本地档案:文件同步、FTS5 搜索、可写 UI | agentsview serve/daemon start |
| PostgreSQL | 团队共享,只读服务 | pg push、pg serve、pg push --watch |
| DuckDB | 便携分析镜像,Quack 协议远程只读 | duckdb push、duckdb quack serve |
| ClickHouse | 可选远端后端 | clickhouse push、clickhouse serve |
此外,session_sources可把其他机器的原生会话目录汇入主实例,Claude/Codex 源支持s3://对象存储根目录;Data 工作区提供项目清单、重新归类预览与 worktree 映射规则管理。桌面应用(Tauri,macOS / Windows / Linux)自带自动更新,与 CLI 共享同一数据目录~/.agentsview/,可单独或并用。
五分钟上手
brew install --cask agentsview # macOS;也可用 install.sh 脚本或 pip install agentsview agentsview serve # 首次运行:自动发现、同步,并打开 Web 界面 agentsview usage daily # 日常:近30天每日成本汇总Windows 走一行 PowerShell 脚本(install.ps1)。桌面应用与 CLI 共用同一守护进程与数据目录,装任意一个即可。源码构建需 Go 1.27.2+(CGO)与 Node.js 24.11+,仓库地址 https://gitcode.com/GitHub_Trending/ag/agentsview ,克隆后make build && make install。
隐私与边界
- 所有会话数据留在本机,服务器默认绑定
127.0.0.1,并校验请求Host头防 DNS 重绑定 - 仅发送极简匿名事件(如
daemon_active,不含会话、项目、文件路径),AGENTSVIEW_TELEMETRY_ENABLED=0一键关闭 - 更新检查可选项,
--no-update-check禁用;对外暴露 UI 时启用--require-auth - MCP 服务器全程只读,不改动档案
下一步
- docs/quickstart.md:安装与首次运行
- docs/token-usage.md:token 用量与成本详解
- docs/activity.md:活动与并发报告
- docs/mcp.md:MCP 服务器配置
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),仅供参考