Conecte suas contas.
Entenda o que você está lendo.

Requisitos e informações de lançamento

O AIUsageWatch é um aplicativo nativo gratuito na barra de menus para macOS 14 ou posterior. O lançamento público está em preparação. Um link verificado para download será adicionado a este site quando estiver disponível. Suas contas nos provedores e as cobranças dos respectivos planos são separadas.

Mova o aplicativo lançado para Aplicativos antes de ativar Abrir ao iniciar sessão. O aplicativo fica na barra de menus e não precisa de um ícone no Dock. Abrir o aplicativo em execução pelo Finder traz Preferências para a frente.

Conecte seus provedores

1. Codex: instale a CLI do Codex e inicie sessão. Aponte a conta para seu diretório de configuração, geralmente ~/.codex. O aplicativo usa o login salvo desse diretório por meio do app-server local da CLI.
2. Claude: a conta padrão ~/.claude usa sua sessão do Safari em claude.ai. Em Preferências, conceda acesso ao arquivo Cookies.binarycookies do Safari. Para um diretório de configuração separado do Claude, inicie sessão com o Claude Code usando esse CLAUDE_CONFIG_DIR; o aplicativo lê seu .credentials.json.
3. Cursor: inicie sessão em cursor.com no Safari e conceda acesso ao arquivo de cookies do Safari em Preferências. O Cursor não usa um diretório de conta para a leitura.
4. Grok: selecione o diretório do Grok que contém logs/unified.jsonl. Execute o Grok para atualizar a leitura de faturamento nesse registro.

O aplicativo lê as informações de cota disponíveis em cada fonte. As fontes de CLI do Claude e do Codex precisam dos respectivos logins salvos. A prévia do site nunca acessa suas contas.

Contas pessoais e de trabalho juntas

Abra Preferências… pelo menu ou pressione ⌘,. Cada conta tem um rótulo, provedor, diretório, cor e letra. Use + para adicionar um diretório; o aplicativo deduz o provedor pelo conteúdo. Confira o provedor antes de usar a nova conta.

Para outro login do Codex, selecione seu CODEX_HOMEseparado. Para outro login do Claude, use um CLAUDE_CONFIG_DIR separado com suas próprias credenciais salvas. A sessão padrão do Claude no Safari pode ser ambígua quando contém várias organizações; nesse caso, use um diretório de configuração separado. O leitor do Cursor usa a sessão disponível do Safari, então adicionar uma linha duplicada do Cursor não cria um login independente.

Mais contas adicionam colunas, com no máximo três linhas em cada coluna. Letras e cores personalizadas ajudam a identificar as contas. As configurações gerais incluem o intervalo de atualização, marcadores de porcentagem, letras e um aviso para informações compatíveis de vencimento de renovações acumuladas do Codex.

Entenda as barras

A parte preenchida significa cota restante. Com 0% restante, não há barra preenchida. A cor identifica uma conta. O menu mostra porcentagens, horários de renovação disponíveis, detalhes relevantes das janelas e status das leituras.

O Claude inclui detalhes semanais e os detalhes disponíveis de cinco horas; o Codex seleciona o limite semanal principal. O Cursor usa seu próprio valor de uso incluído, cujos dados não identificam um período de uso. O Grok usa um valor de créditos semanais do registro da CLI. Porcentagens de provedores diferentes não representam quantidades equivalentes de tokens, prompts ou dólares.

Perceba as renovações acumuladas do Codex antes de vencerem

Quando o Codex informa renovações acumuladas disponíveis e suas datas de vencimento, o AIUsageWatch pode mostrar um ponto de aviso ao lado da conta antes que a próxima renovação acumulada vença. Abra o menu para ver a quantidade disponível e as informações de vencimento. Uma renovação acumulada não utilizada pode ser perdida ao vencer; isso é separado do momento normal em que sua cota semanal é renovada.

Ative Avisar antes da renovação em Preferências e escolha 1–14 dias de antecedência. O padrão é de dois dias, com um ponto de aviso vermelho; você pode mudar a cor. O ponto continua visível quando as letras das contas estão desativadas. O aviso depende de o aplicativo estar em execução, os avisos estarem ativados e os dados de vencimento estarem disponíveis e atualizados. Ele não usa uma renovação acumulada automaticamente nem envia uma notificação do sistema.

A solicitação automática de início do Codex

Quando uma leitura semanal do Codex em tempo real indica 100% restante, o AIUsageWatch envia uma pequena solicitação codex exec usando o login salvo da CLI desse diretório. O objetivo é iniciar uma janela semanal que, caso contrário, pode permanecer inativa. Ela usa o modelo padrão disponível do Codex e consome uma pequena parte da cota dessa conta.

Um ponto vermelho marca a conta enquanto a solicitação está em execução ou se ela falhar. O menu explica o status e permite tentar novamente manualmente. O aplicativo registra a tentativa na memória para aquela janela semanal. Consultas repetidas não enviam mais solicitações para a tentativa já registrada; reabrir o aplicativo limpa a memória e pode resultar em outra solicitação se a leitura em tempo real ainda indicar 100%.

A alternativa de registros históricos das sessões não envia solicitações de início. A solicitação automática de início do Claude não está ativada na versão atual. Isso é separado da leitura de uso, e as preferências atuais não oferecem uma opção para ativar ou desativar a solicitação de início do Codex.

Um número é antigo, está ausente ou é inesperado

• Leitura salva: a última leitura válida fica em cache no seu Mac e é restaurada ao abrir o aplicativo. O menu informa há quanto tempo ela foi obtida quando uma atualização falha.
• Limite de solicitações ou falha de conexão: as novas tentativas são adiadas por 15 minutos após um limite de solicitações e por 2 minutos após outros erros. Atualizar agora ignora essa pausa.
• Conexão com o Safari: confira se a sessão está iniciada no provedor correto, revise a permissão do arquivo de cookies e confirme que a sessão não é ambígua.
• Grok: execute a CLI para registrar uma nova leitura de uso. Uma janela encerrada ou um registro antigo é mostrado como histórico, em vez de um saldo em tempo real.
• Codex: confirme que a CLI está disponível e que o diretório configurado tem o login desejado. A alternativa de registros das sessões pode mostrar informações mais antigas se o app-server estiver indisponível.

Os endpoints e os formatos de dados dos provedores podem mudar. Uma leitura não garante que um provedor aceitará a próxima solicitação. Confira a página da sua conta no próprio provedor quando um saldo ou uma renovação parecerem incorretos.

Configurações locais e conexões com provedores

As preferências e as leituras em cache ficam em ~/Library/Application Support/AiUsageWatch/. O aplicativo não lê diretamente as Chaves. As CLIs dos provedores gerenciam seu próprio comportamento de login. Os leitores em tempo real contatam o provedor relevante usando a sessão ou as credenciais existentes. Leia a política de privacidade para entender a diferença entre armazenamento local do aplicativo, conexões com provedores e mensagens de suporte.

Relate um problema

Entre em contato com o suporte do AIUsageWatch com a versão do aplicativo, a versão do macOS, o provedor, o status da leitura e os passos que reproduzem o problema. Se você usar o modo de diagnóstico --dump , revise a saída antes de enviá-la. Remova tokens, valores de cookies, caminhos privados de contas e qualquer outra informação confidencial. Não envie arquivos de credenciais.