프로젝트 소개

Vole은 AI 코딩 에이전트를 위한 로컬 우선 사용량, 비용, 이상 징후 모니터입니다. 여러 에이전트를 나란히 실행하며 에이전트가 얼마를 소비했는지뿐만 아니라 비정상적으로 동작하고 있는지 알고 싶은 개발자를 위해 설계되었습니다. 이 앱은 Apple Silicon용 macOS 26 이상에서 실행되며 메뉴 막대에 상주합니다. 코딩 도구가 이미 디스크에 기록한 로그를 읽어 공통 스키마로 정규화하고 모든 것을 로컬에 유지합니다. 클라우드 API나 계정이 없으며 프롬프트나 도구 콘텐츠를 저장하지 않습니다. 알림 권한만 선택적으로 요구하며, 로그 소스가 로컬 닷파일과 애플리케이션 지원 파일이기 때문에 전체 디스크 접근 권한을 요청하지 않습니다. Vole은 Claude Code, OpenCode, Codex CLI, Grok CLI, Cursor, Devin, Antigravity를 포함한 여러 도구를 지원합니다. 데이터 신뢰도 등급은 도구 로그에서 직접 읽은 정확한 값, 기록된 방식으로 계산된 결정론적 추정치, 도구가 호출 발생 사실만 기록하고 토큰을 측정할 세부 정보가 충분하지 않을 때의 활동만 있는 행으로 구분됩니다. 합계에는 어떤 등급이 포함되는지 표시되며, 알 수 없는 모델은 추측되지 않고 NULL로 반환됩니다. 대시보드는 주요 토큰 및 비용 수치, 스파크라인, 도구별 막대, 사건이 주석으로 표시된 타임라인을 제공합니다. 타임라인은 도구별로 토큰을 쌓아 보여 주고 사건을 표시해 급증과 그 원인을 더 쉽게 살펴볼 수 있게 합니다. 메뉴 막대 항목은 실시간 토큰, 비용 또는 상태 표시만 보여 줄 수 있으며, 사건이 열려 있는 동안 색상으로 강조됩니다. 이상 징후 감지에는 청구 가능한 소비 급증, 반복 호출 루프, 오류 폭주, 속도 제한 압박, 컨텍스트 압박에 대한 규칙이 포함됩니다. 기준선은 하나의 급증이 자기 자신의 기준선 안에 숨겨지지 않도록 leave-one-out 비교를 사용합니다. 루프 감지는 호출량과 평탄한 출력, 증가하는 캐시 읽기를 결합해 거짓 양성을 줄입니다. 비용은 구독 청구서가 아니라 정가 기준의 API 상당 가치로 계산됩니다. 가격 요율은 버전이 지정된 데이터로 저장되고 설치별로 재정의할 수 있으며, 알 수 없는 모델은 null로 남습니다. 검증 명령은 저장된 행을 원본 레코드에서 독립적으로 다시 파생해 가격이나 파싱 버그를 찾아냅니다. 이 프로젝트에는 실시간 세션, 요약, PR 사용량 표, 상태 줄, 최적화 발견 사항, 예산 한도, 모델 효율성, 상태 확인을 위한 CLI 명령도 포함됩니다. MCP 서버는 동일한 로컬 데이터를 에이전트에 노출해 에이전트가 자체 세션 비용, 컨텍스트 사용량, 사건 상태를 조회할 수 있게 합니다. 예산 한도는 지원되는 훅이 있을 경우 이를 통해 시행될 수 있으며, 훅을 지원하지 않는 도구에서는 권고 사항으로 유지됩니다. 알려진 제한 사항으로는 Devin과 Antigravity의 로컬 토큰 데이터 제한, 부분적으로 파생된 Cursor 메시지 시간, Cursor의 최근 로컬 토큰 수 부족, API 전용 오류 범위, 일부 도구의 하한선 기반 생성 속도, 자사 모델 ID에만 가능한 컨텍스트 윈도우 확인이 있습니다.