vole

Vole é um monitor de uso, custo e anomalias local-first para agentes de codificação de IA. Ele é projetado para desenvolvedores que executam vários agentes lado a lado e querem saber se um agente está apresentando comportamento inadequado, não apenas quanto ele gastou. O aplicativo roda no macOS 26+ para Apple silicon e fica na barra de menus. Ele lê logs que as ferramentas de codificação já gravam em disco, normaliza-os em um esquema comum e mantém tudo local: sem APIs de nuvem, sem conta, e nenhum conteúdo de prompt ou ferramenta é armazenado. Ele exige apenas permissão opcional de notificação e não solicita Acesso Total ao Disco porque as origens são dotfiles locais e arquivos de suporte de aplicativos. Vole suporta várias ferramentas, incluindo Claude Code, OpenCode, Codex CLI, Grok CLI, Cursor, Devin e Antigravity. Ele distingue níveis de confiança de dados: valores exatos lidos diretamente dos logs das ferramentas, estimativas determinísticas com método registrado e linhas apenas de atividade quando uma ferramenta registra que uma chamada ocorreu, mas não há detalhes suficientes para medir tokens. Os totais informam quais níveis incluem, e modelos desconhecidos retornam NULL em vez de serem adivinhados. O painel fornece números principais de tokens e custos, um sparkline, barras por ferramenta e uma linha do tempo anotada por incidentes. A linha do tempo empilha tokens por ferramenta e marca incidentes, tornando picos e suas causas mais fáceis de inspecionar. O item da barra de menus pode mostrar tokens ao vivo, custo ou apenas uma marca de status, e fica colorido enquanto um incidente estiver aberto. A detecção de anomalias inclui regras para picos de consumo faturável, loops de chamadas repetidas, tempestades de erros, pressão de limite de taxa e pressão de contexto. As linhas de base usam comparação leave-one-out para que um único pico não se esconda dentro de sua própria linha de base. A detecção de loops combina volume de chamadas com saída estável e leituras de cache crescentes para reduzir falsos positivos. O custo é calculado como valor equivalente de API pelo preço de tabela, não como faturamento de assinatura. As taxas de preço são armazenadas como dados versionados, podem ser substituídas por instalação e modelos desconhecidos permanecem null. Um comando de verificação deriva novamente de forma independente as linhas armazenadas a partir de seus registros de origem para detectar bugs de preço ou análise. O projeto também inclui comandos CLI para sessões ao vivo, resumos, tabelas de uso de PR, linhas de status, descobertas de otimização, limites de orçamento, eficiência de modelo e verificações de saúde. Um servidor MCP expõe os mesmos dados locais aos agentes, permitindo que um agente consulte o custo de sua própria sessão, uso de contexto e status de incidente. Limites de orçamento podem ser aplicados por meio de hooks suportados onde disponíveis, enquanto permanecem apenas consultivos para ferramentas sem suporte a hooks. Limitações conhecidas incluem dados locais limitados de tokens para Devin e Antigravity, tempos de mensagem do Cursor parcialmente derivados, a recente falta de contagens locais de tokens do Cursor, cobertura de erros apenas por API, velocidades de geração de limite inferior para algumas ferramentas e resolução de janela de contexto apenas para IDs de modelo próprios.