Veja em ação

🎬 Prefere mais qualidade? Assista ao demo em MP4.

A pílula fica na DankBar e mostra o uso ao vivo. Provedores com múltiplas janelas de cota (as de 5 horas e 7 dias do Claude, por exemplo) podem exibir qualquer janela na barra — escolha por provedor, ou deixe highest seguir a mais apertada. Passe o mouse sobre a pílula para ver de qual janela veio o número e quando ela reseta:

Por que AiOverviewControl?

Você paga por Claude, Codex, Copilot, OpenRouter — e cada um esconde a cota em um dashboard, CLI ou API diferente. O AiOverviewControl coleta cada provedor de forma independente e local, normaliza o resultado e renderiza uma visão única e honesta, sem nenhum serviço externo de agregação.

Honesto é a palavra-chave: ele reporta dados medidos quando existe uma fonte suportada e rotula claramente provedores apenas-autenticação ou informativos quando não existe. Sem scraping de dashboards. Sem percentuais inventados. Nunca.

Destaques

Screenshots

Visão geral do dashboard	Cartão de provedor expandido

Modelo de cobertura

Os cartões usam um de seis níveis honestos de cobertura:

Integrações medidas notáveis:

A matriz completa, credenciais e referências upstream estão documentadas em Provedores e Verificação de provedores.

Requisitos

• DankMaterialShell rodando sobre Quickshell.
• bash, jq e curl.
• CLIs ou credenciais específicas apenas para os provedores habilitados. O Antigravity precisa de secret-tool para sessões do keyring ou sqlite3 para bancos de estado da IDE; Hermes e 9Router precisam de sqlite3 para seus bancos locais de uso.
• As notificações de cota também precisam de notify-send e flock.

Linha de base recomendada para o conjunto padrão de provedores:

command -v bash jq curl codex claude gh
codex login
claude auth status
gh auth status

Instalação

Arquivo de release

Baixe o .tar.gz ou .zip da release mais recente, extraia como AiOverviewControl e coloque no diretório de plugins do DMS:

~/.config/DankMaterialShell/plugins/AiOverviewControl

Depois restaure as permissões de execução e reinicie o DMS:

chmod +x ~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-*
dms restart

Clone via Git

git clone https://github.com/bernardopg/AiOverviewControl.git \
  ~/.config/DankMaterialShell/plugins/AiOverviewControl
chmod +x ~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-*
dms restart

Ative AiOverviewControl nas configurações do DMS e adicione-o a uma seção da DankBar. Orientações detalhadas de instalação e upgrade estão em docs/installation.md.

Configuração

As configurações são armazenadas pelo DMS e sobrevivem a upgrades do plugin.

As Configurações também oferecem Exportar histórico de uso (CSV ou JSONL) e um Redefinir configurações do plugin em dois passos, que restaura todas as opções acima sem tocar no histórico registrado.

A seleção padrão de provedores é:

codex,claude,copilot

Provedores com API leem credenciais do ambiente do processo do DMS. Um export disponível apenas em shell interativo pode não chegar a uma sessão gráfica do DMS. Veja Configuração para a matriz de variáveis de ambiente e o comportamento do health-check.

Comportamento do dashboard

• O hero mostra uma visão geral da frota quando dois ou mais provedores resolvem: a carga média nas janelas de cota mensuráveis, o provedor mais quente, quantos estão em ou acima de 80% e o reset mais próximo da frota. Cartões de saldo, analytics, runtime local e informativos ficam intencionalmente fora do denominador da média, para que seus placeholders honestos de 0% não diluam a pressão real de cota. Pico, contagem em risco e reset ainda varrem todos os cartões vivos.
• A visão geral é navegável: clique no provedor de pico do rollup da frota, ou nas barras de uso do hero, para expandir e rolar direto até o cartão daquele provedor.
• Cartões são ordenados com fixados primeiro, depois por maior uso mensurável, com provedores em falha por último.
• Cartões suportam foco por teclado, além de Enter/Espaço (expandir), Delete (remover), P (fixar) e R (tentar novamente).
• Dados ficam obsoletos após o dobro do intervalo de atualização configurado.
• Cartões em falha expõem uma ação de retry específica do provedor.
• Cartões expandidos mostram janelas disponíveis, créditos, fonte, identidade e horário de atualização, sem inventar campos indisponíveis.
• Snapshots de uso são armazenados localmente em ~/.cache/AiOverviewControl/usage-history.jsonl e podados conforme a retenção configurada. O escritor de histórico registra apenas pressão real não-zero de cota/gasto; placeholders 0% informativos, de runtime local, somente-saldo e somente-analytics são ignorados para que as sparklines permaneçam significativas. Suítes de teste baseadas em fixtures exportam um XDG_CACHE_HOME isolado antes de invocar o dispatcher real, então nunca gravam snapshots de fixture no seu histórico real. Como o arquivo é podado, providers/export-usage-history csv|jsonl (também um botão nas Configurações) é a forma de guardar dados de longo prazo.
• O analytics do Claude roda separadamente, para que falhas de histórico local ou de OAuth não bloqueiem a coleta principal.

Privacidade e resiliência

• Credenciais são lidas de CLIs dos provedores, dados locais pertencentes ao provedor ou variáveis de ambiente; a UI nunca exibe valores secretos.
• O plugin não faz scraping de dashboards web autenticados.
• Não chama endpoints pagos de inferência apenas para testar uma chave.
• Arquivos temporários são isolados por execução e removidos ao fim da coleta.
• Erros de provedor retornam como dados estruturados em vez de encerrar todo o refresh.
• Cartões informativos usam texto explícito e links oficiais em vez de percentuais sintéticos.

Validação

jq -e . plugin.json >/dev/null
for file in i18n/*.json; do jq -e . "$file" >/dev/null; done
find providers -maxdepth 1 -type f -print0 | xargs -0 bash -n
for test in tests/*.sh; do bash -n "$test"; done
bash -n scripts/package-release
for test in tests/*.sh; do bash "$test"; done
shellcheck -S warning providers/* tests/*.sh scripts/package-release
qmllint \
  AiOverviewControlWidget.qml \
  AiOverviewControlSettings.qml \
  AiOverviewControlI18n.qml \
  ProviderLogo.qml
./providers/get-provider-health "codex,claude,copilot,pi" | jq .
./providers/get-provider-usage \
  "codex,claude,copilot,pi" \
  ./providers/get-copilot-usage | jq .
./providers/get-usage-history | jq .
./providers/export-usage-history csv /tmp

Arquitetura

AiOverviewControlWidget.qml       Orquestração de runtime e dashboard
AiOverviewControlSettings.qml     Configurações, seleção de provedores e UI de saúde
AiOverviewControlI18n.qml         Carregamento de locales e interpolação
ProviderLogo.qml                  Resolução e fallback dos logos locais de provedores
providers/get-provider-usage      Dispatcher multi-provedor e escritor de histórico
providers/get-provider-health     Verificações locais de pré-requisitos
providers/export-usage-history    Exportação do histórico de uso em CSV ou JSONL
providers/get-codex-usage         Ponte do protocolo codex app-server
providers/get-claude-usage        Ponte de cota e analytics local do Claude
providers/get-copilot-usage       Ponte de cota do GitHub Copilot
providers/get-antigravity-usage   Ponte de cota do Cloud Code Assist do Antigravity
providers/get-9router-analytics   Telemetria local detalhada do 9Router
providers/get-pi-analytics        Telemetria local detalhada de sessões do pi
providers/get-hermes-analytics    Telemetria local do estado do Hermes
providers/get-*-usage             Entrypoints canônicos de provedor único
scripts/package-release           Build e validação dos arquivos de release

Veja Arquitetura para o fluxo de runtime e o contrato normalizado de provedores.

Documentação

Colaboradores

Agradecemos a todos que melhoraram o plugin:

• @emmsixx — corrigiu os comandos de diagnóstico em Settings que codificavam o casing do nome de exibição (AiOverviewControl) em vez do id de manifesto da loja de plugins do DMS (aiOverviewControl), de modo que os comandos copiados resolvam corretamente em sistemas de arquivos sensíveis a maiúsculas/minúsculas (#13).

Contribuições são bem-vindas — veja CONTRIBUTING.md.