Monitor de uso de IA

ai-usagebar

Projeto de Fabio Akita. As integrações de desktop (GNOME · macOS · Windows) mostradas aqui são contribuições do fork do Samir.

                                    Rust
                                    Waybar
                                    GNOME Shell
                                    macOS menu bar
                                    Windows tray
                                    TUI
                                    MIT
                            

O ai-usagebar mostra o quanto você já consumiu dos seus planos de IA — Anthropic Claude, OpenAI Codex, Z.AI (GLM), OpenRouter e DeepSeek — direto na barra do seu sistema, com as barras de uso da 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 quatro interfaces: o widget Waybar e um TUI de terminal (multiplataforma), a extensão de GNOME Shell (Linux), o app de menu bar (macOS) e o app de bandeja (Windows). Todas leem o mesmo --json do binário — a lógica de autenticação e de cada provedor mora 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

Multi-provedor

Claude, Codex, Z.AI, OpenRouter e DeepSeek num só lugar.

UI nativa por SO

Waybar/GNOME no Linux, menu bar no macOS, bandeja no Windows.

TUI multiplataforma

`ai-usagebar-tui` roda em qualquer terminal, 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).

Repositório de Fabio Akita Guia desktop (fork)

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 (GNOME/macOS/Windows) mostradas aqui vêm do fork do Samir. Alguns endpoints são não-documentados; as marcas citadas pertencem aos respectivos donos.