Pular para o conteúdo
nandomoreira.dev

CLI, automação e desktop Linux

AI Bar

Plugin para o Noctalia Shell que mostra na barra quanto do plano do Claude Code e do Grok já foi usado: a porcentagem da janela mais crítica, o tempo até ela reiniciar e uma barra de progresso. No painel, cada janela aparece com o ritmo de uso, adiantado ou atrasado em relação ao tempo que passou.

O problema

Saber quanto do plano de uso do Claude Code e do Grok ainda restava exigia abrir uma página de cada serviço, e o limite costumava aparecer só quando já tinha estourado, no meio do trabalho.

Decisões técnicas

Plugin do próprio shell, na barra que já fica à vista, seguindo a arquitetura do Daybar: a lógica toda em funções JavaScript puras testadas com Vitest, e o QML só como tela. As credenciais das CLIs são apenas lidas, nunca gravadas, copiadas ou renovadas, e o token vai só no cabeçalho da requisição. Uma requisição que falha mantém o último dado bom marcado como desatualizado, em vez de esvaziar a barra. O ritmo compara a porcentagem usada com a porcentagem do tempo que já passou na janela. Endpoints e armadilhas vieram do ai-usagebar, do Fabio Akita, sem reaproveitar o código.

Resultado

Uso próprio no meu desktop com CachyOS, publicado em licença MIT, com 36 testes. Avisa uma vez quando uma janela passa de 97%. Testado no Noctalia 4.7.7; o port para o Noctalia v5 está planejado.

Imagens