VasiHemanth/tokentelemetry

해결하는 문제

TokenTelemetry는 AI 코딩 에이전트와 자율 에이전트를 위한 로컬, 제로 구성 관측성 대시보드를 제공합니다. 이는 사용자가 다양한 프로젝트와 모델에 걸쳐 여러 AI 에이전트(Claude Code, Cursor, Gemini CLI 등)의 비용, 토큰 사용량, 내부 추론 단계를 단일 통합 뷰에서 쉽게 추적할 수 없는 '토큰 사각지대' 문제를 해결합니다.

작동 방식

TokenTelemetry는 SDK나 클라우드 계정을 요구하는 대신, AI 에이전트가 이미 머신에 기록하고 있는 로컬 세션 로그를 읽습니다. 이 로그를 실시간으로 파싱하여 토큰 수, 도구 호출, 추론 체인을 추출하고 FastAPI 백엔드와 Next.js 프론트엔드를 통해 표시합니다. 100% 로컬에서 실행되도록 설계되어 프롬프트와 사용 데이터가 사용자의 머신을 절대 벗어나지 않도록 보장합니다.

대상 사용자

여러 AI 코딩 에이전트나 자율 에이전트(예: Hermes Agent)를 사용하며, 데이터를 타사 클라우드로 전송하지 않고도 API 지출을 모니터링하고, 토큰 효율성을 추적하며, AI 기반 워크플로우의 내부 로직을 감사하고자 하는 개발자 및 파워 유저.

주요 특징

• 멀티 에이전트 지원: Claude Code, Cursor, Copilot, Gemini CLI, Hermes Agent를 포함한 광범위한 에이전트에 대한 통합 추적.
• 로컬 우선 개인정보 보호: 모든 로그, 세션, 비용은 로컬에서 처리되며 클라우드 계정이나 가입이 필요하지 않습니다.
• 상세 추적: 시스템 프롬프트, 추론 단계, 도구 호출의 워터폴 뷰를 통해 에이전트가 결과에 도달한 과정을 정확히 확인 가능.
• 비용 및 예산 관리: 실시간 비용 추적과 관측 예산 및 알림 기능을 통해 프로젝트나 에이전트별 지출 모니터링.
• 플랜 제한 추적: 머신의 로그인 상태에서 실제 제공업체의 할당량(예: 세션 또는 주간 제한)을 직접 읽어옵니다.
• Hermes Agent 통합: 소스 플랫폼 추적, 게이트웨이 상태, 하위 에이전트 카드를 갖춘 자율 에이전트 전용 대시보드.