Pular para o conteúdo
Monitor de uso de IA

ai-usagebar

Projeto de Fabio Akita. As integrações de desktop de GNOME e macOS mostradas aqui nasceram no fork do Samir e foram adotadas pelo upstream.

Rust Waybar GNOME Shell macOS menu bar TUI MIT

O ai-usagebar mostra quanto você já usou dos seus planos de IA — Anthropic Claude, OpenAI Codex, Z.AI (GLM), OpenRouter, DeepSeek e mais nove — direto na barra do sistema, com as barras de uso das janelas de janela de 5 horas e semanal ao lado do relógio e um menu com o detalhamento completo.

É um backend rápido em Rust com três interfaces: o widget do Waybar e um TUI de terminal (multiplataforma), a extensão do GNOME Shell (Linux) e o app de menu bar (macOS). Todas leem o mesmo --json do binário — a lógica de autenticação e cada provedor vivem só no Rust auditável.

Painel do GNOME mostrando as barras de uso do Claude com o menu suspenso aberto
Barras de uso ao lado do relógio + menu com Sessão / Semanal / Sonnet / Uso extra.

Recursos

Quatorze provedores

Claude, Codex, Z.AI, OpenRouter, DeepSeek, Kimi, Grok, MiniMax, ShvIA e outros, num lugar só.

UI nativa por SO

Waybar e extensão do GNOME no Linux, menu bar no macOS.

TUI multiplataforma

`ai-usagebar-tui` roda em qualquer terminal, nos três sistemas, até por SSH.

Auto-refresh

Atualiza a cada 60s no app; cache com flock evita rate-limit.

Sem reimplementar auth

Lê o OAuth que o `claude`/`codex` já gravaram; chaves por env/config.

Drop-in claudebar

Mesmos flags e placeholders do claudebar original, em Rust.

Antes de tudo: entre uma vez no provedor

O ai-usagebar não pede login próprio — ele lê as credenciais que os CLIs oficiais já gravam. Para o Claude, rode o Claude Code uma vez; o token se renova sozinho depois.

$ claude        # Linux/Windows → ~/.claude/.credentials.json  ·  macOS → Keychain (lido sozinho)
$ codex login   # OpenAI Codex → ~/.codex/auth.json
Z.AI, OpenRouter e DeepSeek usam chave de API (variável de ambiente ZAI_API_KEY / OPENROUTER_API_KEY / DEEPSEEK_API_KEY, ou inline no ~/.config/ai-usagebar/config.toml). Dá pra configurar direto pela aba Vendors das UIs.

Como instalar

Escolha o seu sistema. Os comandos são os mesmos do repositório oficial.

1. Instale o binário

No Arch, use o AUR. Em outras distros, use o crates.io (precisa de rustup, ou cargo-binstall para baixar pronto).

# Arch (AUR) — escolha um:
$ yay -S ai-usagebar-bin     # binário pronto das Releases (~5s)
$ yay -S ai-usagebar         # compila do fonte (~30-60s)

# Outras distros (crates.io):
$ cargo install ai-usagebar  # compila do fonte (precisa de rustup)
$ cargo binstall ai-usagebar # baixa o binário pronto (precisa de cargo-binstall)

Instala ai-usagebar + ai-usagebar-tui. Teste na hora:

$ ai-usagebar --vendor anthropic --pretty   # deve imprimir as barras
$ ai-usagebar-tui                            # TUI com abas — funciona sozinho, sem Waybar

2a. Extensão de GNOME Shell

$ cd gnome-extension
$ ./install.sh          # symlink em ~/.local/share + compila o schema GSettings
# Recarregue o GNOME Shell: FAÇA LOGOUT / LOGIN (não use gnome-shell --replace)
$ gnome-extensions enable ai-usagebar@akitaonrails.github.io
$ gnome-extensions prefs  ai-usagebar@akitaonrails.github.io   # barras, cores, login de Vendors
Preferências do GNOME — aba Vendors
Preferências → aba Vendors (login/config por provedor).
Barras no painel do GNOME
As barras aparecem no painel superior, ao lado do relógio.

2b. Widget do Waybar (Wayland)

Um módulo só, com scroll para alternar entre provedores e clique para abrir o TUI. Adicione ao seu ~/.config/waybar/config:

"custom/aibar": {
    "exec": "ai-usagebar --format '{vendor_short} {session_pct}% · {session_reset}'",
    "return-type": "json",
    "interval": 300,
    "signal": 13,
    "tooltip": true,
    "on-click": "ai-usagebar-tui",
    "on-scroll-up":   "ai-usagebar --cycle-next",
    "on-scroll-down": "ai-usagebar --cycle-prev"
}
Mantenha interval: 300. Os endpoints da Anthropic e da OpenAI são não-documentados e aplicam rate-limit abaixo de ~300s. O cache interno de 60s deixa várias telas conviverem sem estourar a API.
Widget do Waybar mostrando o uso do Claude com o tooltip
Widget no Waybar com o tooltip de detalhamento (Pango).
TUI mostrando a aba da OpenAI
`ai-usagebar-tui` — abas por provedor (aqui, OpenAI Codex).

O que mudou

Os lançamentos mais recentes, tirados do changelog do próprio projeto.

  1. v0.16.0 atual
    • O Google Antigravity entra na lista de provedores, informando as quatro janelas reais de cota — um limite de 5 horas e um semanal para cada um dos dois grupos de modelos — sem nenhuma credencial para configurar.
    • A extensão do GNOME passa a suportar o Shell 45 até o 50, antes 45–48.
    • As bordas do tooltip não saem mais quebradas quando um rótulo contém &, < ou >.
  2. v0.15.0
    • O monitor de contexto se encaixa no painel, com uma tecla para alternar entre inteiro, dividido e rodapé.
    • O gasto em créditos deixa de ficar escondido em planos sem teto, e o uso extra aparece na moeda dele em vez de um cifrão fixo.
  3. v0.14.0
    • Um monitor local do contexto do Claude Code, opcional, desligado até você ligar e lendo só trechos limitados — sem varrer o disco.
    • Quatro provedores de saldo em conta: Kilo, Novita, Moonshot e xAI/Grok. Esses mostram dinheiro, não porcentagem de uso.
  4. v0.13.0
    • O Kimi entra na lista de provedores.
    • As marcas de ritmo — se você está adiantado ou atrasado em relação ao consumo — chegam ao menu bar do macOS e ao GNOME.
    • Corrige uma barra travada em "Sonnet only 0%", linhas cortadas nas preferências do macOS e nomes de chave de API vazando no texto de erro.
  5. v0.12.0
    • Limites semanais por modelo passam a aparecer nas interfaces de desktop.

O trabalho posterior deste fork — os provedores ShvIA e MiniMax, e o painel de status das APIs — já está entregue, mas ainda não ganhou uma versão própria.

Repositório de Fabio Akita Este fork no GitHub

ai-usagebar é um projeto de Fabio Akita — open-source (MIT), port em Rust do claudebar com suporte a mais provedores. As integrações nativas de desktop de GNOME e macOS mostradas aqui nasceram no fork do Samir e foram adotadas pelo upstream. Alguns endpoints são não-documentados; as marcas citadas pertencem aos respectivos donos.