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 效率和成本的工具。