VasiHemanth/tokentelemetry

解决的问题

TokenTelemetry 为 AI 编码代理与自主代理提供了一个本地、零配置的可观测性仪表板。它解决了“Token 盲点”问题——即用户无法在单一统一视图中，轻松追踪不同项目与模型中各种 AI 代理（如 Claude Code、Cursor 和 Gemini CLI）的成本、Token 使用量与内部推理步骤。

运作原理

TokenTelemetry 不需要 SDK 或云端账户，而是读取 AI 代理已写入机器的本地会话日志。它实时解析这些日志以提取 Token 计数、工具调用与推理链，并通过 FastAPI 后端与 Next.js 前端呈现。它设计为 100% 本地运行，确保提示词与使用数据绝不会离开用户的机器。

目标对象

使用多种 AI 编码代理或自主代理（例如 Hermes Agent），并希望在不将数据发送到第三方云端的情况下，监控 API 支出、追踪 Token 效率并审核 AI 驱动工作流程内部逻辑的开发者与进阶用户。

特色亮点

• 多代理支持：为包括 Claude Code、Cursor、Copilot、Gemini CLI 与 Hermes Agent 在内的广泛代理提供统一追踪。
• 本地优先隐私：所有日志、会话与成本均在本地处理；无需云端账户或注册。
• 详细追踪：系统提示词、推理步骤与工具调用的瀑布流视图，可精确查看代理如何得出结果。
• 成本与预算管理：实时成本追踪，具备观察性预算与警报，可监控每个项目或代理的支出。
• 方案限制追踪：直接从机器的登录状态读取实际的供应商配额窗口（例如会话或每周限制）。
• Hermes Agent 集成：专为自主代理设计的仪表板，具备来源平台追踪、网关健康状况与子代理卡片功能。