Voltar para o Blog
Artigoverboo codetutorialdev toolsprodutividade

Verboo Code: como ler suas estatísticas de uso com /stats

Mafra18 de novembro de 20266 min de leitura

Você já rodou dezenas de sessões nesta semana e não sabe dizer quantos dias seguidos está usando a CLI, qual modelo puxa mais token no seu fluxo ou se o seu trabalho acontece em rajadas ou de forma constante. O /stats responde isso num painel só, montado a partir dos transcripts que já estão no seu disco.

Este artigo mostra o que cada aba traz, quais teclas navegam o painel, por que o número de hoje pode mudar no meio do dia e de onde exatamente o comando lê os dados.

O que o comando /stats mostra?

Duas abas. A Overview traz um heatmap de atividade no estilo GitHub, o modelo favorito, total de tokens, número de sessões, sessão mais longa, dias ativos, maior sequência e sequência atual. A Models quebra o consumo por modelo, com gráfico de tokens por dia.

Como abrir e navegar o painel?

Digite o comando dentro de uma sessão normal da CLI.

/stats

Enquanto os dados carregam aparece Loading your Verboo Code stats…. Depois o painel abre e responde a cinco teclas:

TeclaO que faz
TabAlterna entre Overview e Models
rAlterna o período: All time, depois Last 7 days, depois Last 30 days, e volta
↑ ↓Rola a lista de modelos na aba Models
ctrl+sCopia um screenshot do painel atual para o clipboard
EscFecha o painel

O rodapé do painel repete os atalhos: Esc to cancel · r to cycle dates · ctrl+s to copy. Os rótulos da interface estão em inglês mesmo na versão em português, então Last 7 days é a janela de sete dias e All time é tudo o que existe no disco.

O que cada linha da Overview significa?

Cada linha vem de um cálculo diferente, e é por isso que duas delas podem parecer contraditórias na mesma tela.

LinhaO que conta
HeatmapUm quadradinho por dia, uma coluna por semana, até 52 semanas. A intensidade é relativa ao seu próprio histórico: os percentis de mensagens por dia definem o que é dia fraco, médio e forte
Favorite modelO modelo com mais tokens somados (entrada mais saída) no período selecionado
Total tokensSoma de entrada e saída de todos os modelos no período
SessionsQuantos transcripts principais existem no período. Cada sessão conta uma vez, pela data da primeira mensagem
Longest sessionDiferença entre a primeira e a última mensagem da sessão mais longa, não o tempo com o terminal aberto
Active daysDias com pelo menos uma sessão, sobre o total de dias do período
Longest streakMaior sequência de dias consecutivos com sessão, dentro do período
Current streakDias consecutivos até hoje. Este número é sempre de todo o histórico, mesmo com período filtrado
Most active dayO dia com mais mensagens no período

O heatmap ignora o filtro de período. Ele sempre desenha o histórico inteiro, porque serve para mostrar padrão de longo prazo. Se você trocar para Last 7 days e o heatmap continuar cheio, está certo: só as linhas de número abaixo dele mudam.

Como ler a aba Models?

A aba lista os modelos ordenados por volume de tokens, do maior para o menor, com quatro visíveis por vez. Cada entrada mostra o total de tokens e um gráfico de barras com os tokens daquele modelo por dia.

Total tokens: 12,480,331

sonnet-4.6        8,120,004
▁▂▃▅▇▆▄▃▂▁▂▄▆▇▅▃▂
opus-4.6          3,204,112
▁▁▂▂▃▄▂▁▁▂▃▅▄▂▁▁

Se a lista estiver vazia, o painel mostra No model usage data available. Isso acontece quando o período selecionado não tem nenhuma resposta de modelo registrada, o que é comum em Last 7 days depois de uma semana sem uso.

Use esta aba para responder uma pergunta específica: qual modelo está consumindo o seu fluxo. Um modelo de raciocínio pesado no topo com poucas sessões indica que você está usando o modelo caro para tarefa simples. Se quiser trocar de modelo no meio da sessão, o comando é /model.

Por que o número de hoje muda durante o dia?

Porque o histórico é lido de um cache e o dia atual é sempre recalculado ao vivo. O comando mantém um arquivo stats-cache.json no diretório de configuração da CLI, com tudo o que já foi agregado até ontem. Cada abertura do painel reprocessa só o dia de hoje, que ainda está incompleto, e soma ao cache.

Na prática: abrir o /stats de manhã e de novo à noite dá números diferentes no mesmo dia, e isso não é bug. Os dias anteriores ficam estáveis, o dia corrente não.

Já as janelas Last 7 days e Last 30 days não usam o cache: elas releem os arquivos de sessão e filtram pela data. Por isso a primeira troca de período pode levar alguns segundos em um diretório com muitos transcripts, e as seguintes são instantâneas.

A armadilha da sessão retomada. Sessão que começou no mês passado e você retomou hoje não entra na janela de sete dias, mesmo que tenha mensagens de hoje. O filtro olha a data da primeira mensagem da sessão, então ela pertence ao dia em que nasceu. Se um número não fecha, é o primeiro lugar para olhar.

De onde vêm os dados?

Dos transcripts locais, não do servidor. O comando lê o diretório principal de sessões, ~/.claude/projects por padrão ou o caminho definido em VERBOO_PROJECTS_DIR, e inclui também os transcripts de subagente, que ficam em {projeto}/{sessão}/subagents/agent-*.jsonl.

Isso explica três comportamentos que costumam confundir:

  • Subagente não é sessão. Os tokens e as chamadas de ferramenta dele entram na conta, mas ele não soma em Sessions nem no heatmap.
  • Sessão pertence ao dia em que começou. Uma sessão longa que atravessa a meia-noite fica toda no dia da primeira mensagem.
  • Máquina nova começa vazia. Sem transcripts no disco, o painel abre com No stats available yet. Start using Verboo Code! e nada mais. Não há sincronização de histórico entre máquinas.

Para consumo do plano, o número certo é outro painel: o /usage mostra o que a conta já gastou na janela de limite, incluindo outras máquinas. Para o custo e a duração da sessão atual, use o /cost. O /stats é histórico de atividade, não de cobrança.

Perguntas rápidas

O /stats mostra dados de outra máquina? Não. Ele lê o disco local, então cada máquina tem o seu histórico.

Dá para exportar o número? O ctrl+s copia uma imagem do painel atual para o clipboard. Para dado em texto, a fonte é o próprio stats-cache.json no diretório de configuração.

Apagar um projeto remove o histórico dele? Sim. O cálculo parte dos arquivos de transcript, então transcript apagado sai do histórico na próxima agregação.

Por que a sequência atual não muda quando eu troco o período? Porque ela é sempre calculada sobre todo o histórico, de propósito, para não premiar quem filtrou a tela.

Abra a CLI, rode /stats e olhe o heatmap antes de qualquer coisa. Em cinco segundos você vê se o seu uso é constante ou em rajadas, e isso muda como você planeja a semana. Se você ainda não usa a Verboo Code, comece por verboo.ai e rode o mesmo comando no primeiro dia.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados