Plugin AI Usage no Omarchy

O AI Usage coloca na barra do Omarchy o consumo da sua cota de IA, com uma entrada por provedor. Claude, Codex, GitHub Copilot, Z.AI, OpenRouter, DeepSeek, Kimi e mais de uma dezena de serviços aparecem com percentual, janelas de limite e o tempo até o próximo reset, sem você abrir o painel de cada fornecedor.

O plugin é a camada visual de um programa separado. O executável ai-usagebar faz as chamadas e monta o relatório. O painel em Quickshell apenas lê esse relatório e desenha. Quando o binário não está instalado, a barra mostra ai-usagebar is not installed em vez de um número errado.

Essa divisão explica por que a instalação tem duas partes e por que vale conferir a versão do programa antes de abrir uma issue.

Antes de instalar

O executável vem de um pacote do sistema, enquanto o plugin é configuração de shell por usuário em ~/.config/omarchy/plugins/. O README recomenda ai-usagebar-bin, que baixa o ELF x86_64 compilado pela CI, ou o pacote ai-usagebar, que compila na sua máquina com o mesmo resultado em /usr/bin/.

Cada provedor precisa da credencial que ele já usa: Claude e Codex reaproveitam o OAuth das CLIs oficiais, então basta rodar claude e codex login uma vez. Os demais usam chave de API, login de um aplicativo existente ou um serviço local e ficam desligados até você ligar.

O Quattro já traz o widget omarchy.agents ligado. Para o AI Usage ser o único item de status de agentes na barra:

1
omarchy plugin disable omarchy.agents

Instale

São dois comandos, nesta ordem, porque o plugin não empacota o binário:

1
omarchy pkg aur add ai-usagebar-bin &&
2
  omarchy plugin add https://github.com/akitaonrails/ai-usagebar.git --enable

O botão Install do catálogo copia só a segunda linha. Numa instalação feita por ali, a barra diz que o programa não existe até você rodar a primeira metade.

Use o painel

Clique com o botão esquerdo no widget para abrir o painel nativo de consumo. Dentro dele, a engrenagem ou a tecla s abre os ajustes em QML. O botão direito abre a TUI num terminal e não é o atalho de configuração. O botão do meio ou a roda do mouse alternam entre os provedores ligados.

A TUI tem três modos de navegação: barra lateral, barra superior ou sem caixa de fornecedor. A visão se atualiza a cada 60 segundos. O provedor escolhido continua selecionado depois de recarregar o shell e de acordar da suspensão.

Ajuste a barra

Uma métrica desligada sai do painel, da barra e do tooltip e fica fora do cálculo do maior percentual que define o valor da barra e o estado de alerta. A última métrica ligada não pode ser desligada.

Configure os provedores

O arquivo de configuração é opcional e fica em ~/.config/ai-usagebar/config.toml. Claude, Codex, Z.AI e OpenRouter vêm ligados. Os outros provedores entram por opt-in. Um exemplo mínimo:

1
[ui]
2
primary = "openai"
3

4
[kimi]
5
enabled = true

As notificações de limite vêm ligadas em 97% e geram um aviso por cruzamento, com o limite crítico em 100%. Para desligar ou mudar o marco:

1
[notifications]
2
enabled = false
3
threshold = 90

Chaves digitadas nos ajustes em QML vão para o comando de configuração por stdin em vez de argumento de linha de comando. O plugin não guarda outra cópia das chaves, apenas lê o que já está no config.toml e nas CLIs.

Atualize e remova

1
omarchy plugin update akitaonrails.ai-usagebar
2
omarchy plugin remove akitaonrails.ai-usagebar

O binário é um pacote do sistema e não sai junto com o plugin. Remova-o pelo gerenciador de pacotes que você usou na instalação. Enquanto ele estiver presente, o comando ai-usagebar usage --json continua disponível para scripts. O ai-usagebar mcp expõe a mesma leitura como servidor local para clientes de MCP.