VasiHemanth/tokentelemetry

解决的问题

TokenTelemetry 为 AI 编程和自主代理提供了一个本地、零配置的可观测性仪表板。它解决了在多个不同代理（如 Claude Code、Cursor 和 Gemini CLI）之间追踪 Token 使用量、LLM API 成本和执行追踪的问题，且不需要云账户、SDK 或手动插桩。

工作原理

TokenTelemetry 不需要 API 或 SDK，而是自动检测并读取 AI 代理写入本地机器的会话日志文件。然后它会解析这些日志，提供关于 Token 消耗速率、成本追踪和工具调用成功率的实时分析。它由一个读取日志的 FastAPI 后端和一个用于仪表板的 Next.js 前端组成。

适用人群

使用多个 AI 编程代理或 Hermes Agent 框架，并希望在本地和私密环境下监控其花费和性能的开发人员与高级用户。

亮点

• 多代理支持：为包括 Claude Code、Gemini CLI、Cursor、GitHub Copilot 等在内的代理提供统一视图。
• 本地优先隐私：所有数据、提示和成本都保留在本地机器上；无需注册云服务。
• 专属 Hermes 仪表板：为 Hermes Agent 提供专门的可观测性，包括对 38 个源平台的支持和子代理追踪。
• 会话追踪：整个推理链的瀑布流视图，从系统提示到工具调用和最终输出。
• 观测预算：能够为每个项目设置花费或 Token 限制，并在 80% 和 100% 阈值时发出警报。
• 模型分析：比较不同 LLM 模型在各个项目中的 Token 效率和成本的工具。