Métricas do Claude Code e do Grok
Code Critter
Um familiar pixel que acompanha suas sessões do Claude Code e do Grok e reage em tempo real: app de desktop para macOS, Windows e Linux, e plugin do Stream Deck. Sessões ao vivo, /loop, tokens, custo e burn rate, tudo lido 100% localmente.
0
chamadas de API · 100% local
App de desktop
Um app de desktop
A versão autônoma para macOS, Windows e Linux: um companion na barra de menus (ou na bandeja do sistema no Windows e no Linux) que mostra suas estatísticas do Claude Code e do Grok sem Stream Deck. O mesmo motor do plugin, então os números batem.
O que ele faz
Sessões ao vivo, fleet, loops, tokens, custo por projeto, burn rate, modelos Claude e Grok, contadores, atividade, conta. Mostre, oculte, reordene. Burn em 24 h, 7 d ou 30 d, e custo por projeto em 1 d, 7 d, 30 d ou desde o início: cada período a um clique.
Uma linha por sessão em curso, nomeada pelo título (seu /rename, o título automático do Claude Code ou o gerado pelo Grok, senão o repo): tempo desde a última atividade, anel de contexto, tokens de entrada, tokens de saída, leituras de cache e custo equivalente-API. Clique num cabeçalho para ordenar.
O companion fica no topo da tela, ao lado do relógio. O humor segue a sua fleet (working, waiting, done), com um piscar opcional quando uma sessão espera você.
Veja quais sessões estão em loop: um marcador ↻, um quadrado LOOP na fleet, um cartão Loops com cadência e contagem regressiva. Lido direto do transcript.
Você é avisado quando uma sessão espera você, quando um trabalho é entregue ou quando um /loop termina, mesmo com o app fechado. O título nomeia a sessão ({session_name}), com ajustes globais, por sessão e para sessões novas, e um texto ajustável.
No macOS, clique numa sessão para ir direto à janela ou à aba dela, mesmo em segundo plano. Ghostty, Terminal.app, iTerm2 e outros.
O uso do Claude não é mais contado em dobro, subagentes e chamadas a um modelo conselheiro entram na conta, o custo do Grok vem do custo por turno informado pelo Grok, e um modelo sem preço conhecido é sinalizado em vez de aparecer como 0 $. Os custos continuam uma estimativa equivalente-API, não o preço do seu plano.
Ele reage, na sua barra de menus
RUN A fleet está rodando, tudo verde.
Três temas, claro/escuro automático
Também no seu Stream Deck
A mesma coisa no hardware: uma criatura pixel mora numa tecla e reage à sua fleet em tempo real, cercada de tiles ao vivo.
RUN A fleet está rodando, tudo num relance.
O companion reage
uma sessão está rodando
uma sessão espera você
trabalho entregue
tudo quieto
Os 13 tiles
Seu familiar pixel reativo, 12 skins.
A contagem ao vivo de cada sessão num tile: RUN, INPUT, END.
Quantas sessões estão num estado: RUN, INPUT ou END.
Uma sessão específica: título, % de contexto, tokens de entrada e saída, leituras de cache ou custo, com um ↻ se estiver num /loop.
Quantas sessões rodam um /loop, com a contagem regressiva do próximo run.
Sequência e mapa de calor de 12 semanas.
Uso de tokens por hora, o seu pico.
Hoje, lifetime, ou uma sparkline de 24 h. Tokens faturados por padrão, leituras de cache à parte.
Gasto equivalente-API, de hoje ao lifetime. Um ! marca um modelo sem preço conhecido.
Gasto por projeto e por modelo.
Tokens por minuto na última hora.
Contador dia/semana: permissões, runs, subagentes, loops iniciados ou iterações.
Um resumo compartilhável das suas estatísticas.
Local-first e privacidade
O Code Critter foi feito para ser entediantemente seguro com os seus dados.
- ›Lê os arquivos locais do Claude Code em ~/.claude e os do Grok, somente leitura.
- ›Nenhuma chamada de rede, nenhuma API. Nem conta, nem chave.
- ›Nenhuma telemetria. Nada é coletado, armazenado remotamente ou compartilhado.
- ›Os custos são uma estimativa equivalente-API, não uma fatura, e não saem da sua máquina.
Instalação
Instale o app de desktop (macOS, Windows ou Linux), ou o plugin do Stream Deck (veja Downloads) e arraste qualquer tile para uma tecla. Tokens, custo, custo por projeto e atividade funcionam na hora.
Sessões ao vivo: por que precisa de um hook
Alguns tiles precisam saber se uma sessão trabalha, espera ou terminou: um estado que o Claude Code e o Grok não guardam em lugar nenhum. Um hook pequeno captura isso.
-
Sem nada
Tokens, custo, custo por projeto e atividade já funcionam: Claude Code e Grok escrevem os transcripts.
-
O que falta
O estado ao vivo (
working,waiting,done) não existe em nenhum arquivo. -
O hook
Um plugin escuta os eventos do Claude Code ou do Grok e grava o estado em
~/.claude/deck-stateou~/.grok/deck-state, lido pelo app.
A detecção de /loop não pede ajuste nenhum: o tile Session mostra um ↻, o tile Loops conta os loops ativos, e tudo é lido do transcript, sempre 100% local.
O app de desktop instala os hooks sozinho, para Claude Code e para Grok: nada a fazer aqui. Sem ele, no Claude Code, ativar o plugin instala automaticamente:
Um comando de cada vez: copie, cole, confirme, e então o próximo.
- 1
/plugin marketplace add https://github.com/denisvinciguerra/code-critter-hooks - 2
/plugin install code-critter@code-critter - 3
/reload-plugins
Para o Grok, num terminal (mesmo sem o plugin do Claude Code), e depois abra uma sessão nova do Grok:
- 1
grok plugin marketplace add https://github.com/denisvinciguerra/code-critter-hooks - 2
grok plugin install code-critter --trust
FAQ
Preciso de uma chave de API da Claude ou da Anthropic? +
Não. O Code Critter só lê os arquivos que o Claude Code já grava na sua máquina. Não há chamada de API nem chave para digitar.
O valor de custo é a minha fatura real? +
Não. Numa assinatura fixa não há fatura por token, então o tile de custo mostra uma estimativa equivalente à tarifa de API, identificada como tal.
Um tile mostra um traço ou zero. +
Ainda não há dados locais para essa métrica. O tile se preenche conforme você usa o Claude Code.
O companion está sempre dormindo, ou meus tiles Fleet / Session estão vazios. +
Esses tiles ao vivo precisam dos hooks opcionais do Claude Code ou do Grok: o app de desktop instala, senão veja Instalação. Tokens, custo e atividade funcionam sem eles.
Downloads
O repositório no GitHub está privado por enquanto, abre em breve.