Ligue as suas contas.
Saiba o que está a ler.

Requisitos e informações de lançamento

O AIUsageWatch é uma aplicação nativa e gratuita para a barra de menus do macOS 14 ou posterior. O lançamento público está em preparação. Será adicionada a este site uma ligação de descarga verificada quando estiver disponível. As suas contas nos fornecedores e os encargos dos respetivos planos são separados.

Mova a aplicação lançada para Aplicações antes de ativar Abrir ao iniciar sessão. A aplicação fica na barra de menus e não precisa de um ícone na Dock. Abrir a aplicação em execução a partir do Finder traz as Preferências para primeiro plano.

Ligue os seus fornecedores

1. Codex: instale e inicie sessão na CLI do Codex. Indique na conta o seu diretório de configuração, normalmente ~/.codex. A aplicação usa o início de sessão guardado nesse diretório através do app-server local da CLI.
2. Claude: a conta predefinida ~/.claude usa a sua sessão de claude.ai no Safari. Nas Preferências, conceda acesso ao ficheiro 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; a aplicação lê o respetivo ficheiro .credentials.json.
3. Cursor: inicie sessão em cursor.com no Safari e conceda acesso ao ficheiro de cookies do Safari nas Preferências. O Cursor não usa um diretório de conta para a sua leitura.
4. Grok: selecione o diretório do Grok que contém logs/unified.jsonl. Execute o Grok para atualizar a leitura de faturação nesse registo.

A aplicação lê a informação da quota disponível em cada fonte. As fontes da CLI do Claude e do Codex precisam do respetivo início de sessão guardado. A pré-visualização do site nunca acede às suas contas.

Contas pessoais e de trabalho em conjunto

Abra Preferências… a partir do menu ou prima ⌘,. Cada conta tem um nome, fornecedor, diretório, cor e letra. Use + para adicionar um diretório; a aplicação deduz o fornecedor a partir do seu conteúdo. Verifique o fornecedor antes de usar a nova conta.

Para outro início de sessão do Codex, selecione um diretório separado CODEX_HOME. Para outro início de sessão do Claude, use um diretório separado CLAUDE_CONFIG_DIR com as suas próprias credenciais guardadas. A sessão predefinida 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 no Safari, pelo que adicionar uma linha duplicada do Cursor não cria um início de sessão independente.

Mais contas acrescentam colunas, com um máximo de três linhas por coluna. Letras e cores personalizadas ajudam a identificar as contas. As definições gerais incluem o intervalo de atualização, marcadores de percentagem, letras e um aviso para a informação suportada sobre a validade das reposições acumuladas do Codex.

Compreenda as barras

A parte preenchida significa quota restante. Com 0% de quota restante, não há barra preenchida. A cor identifica uma conta. O menu mostra percentagens, horas de reposição disponíveis, detalhes dos períodos relevantes e o estado da leitura.

O Claude inclui detalhes semanais e os detalhes disponíveis do período de cinco horas; o Codex seleciona o limite semanal principal. O Cursor usa o seu próprio valor de utilização incluída, cujos dados não indicam um período de utilização. O Grok usa um valor de créditos semanais do registo da CLI. Percentagens de fornecedores diferentes não equivalem a números iguais de tokens, pedidos ou dólares.

Detete reposições acumuladas do Codex antes de expirarem

Quando o Codex comunica reposições acumuladas disponíveis e as respetivas datas de validade, o AIUsageWatch pode mostrar um ponto de aviso junto da conta antes de a próxima reposição acumulada expirar. Abra o menu para ver o número disponível e a informação de validade. Uma reposição acumulada não utilizada pode perder-se quando expira; isto é distinto do momento normal em que a sua quota semanal é reposta.

Ative Avisar antes da reposição nas Preferências e escolha 1–14 dias de antecedência. A predefinição é de dois dias, com um ponto de aviso vermelho; pode mudar a cor. O ponto mantém-se visível quando as letras das contas estão desativadas. O aviso depende de a aplicação estar em execução, de os avisos estarem ativados e de os dados de validade estarem disponíveis e atualizados. Não usa automaticamente uma reposição acumulada nem envia uma notificação do sistema.

O pedido automático de início do Codex

Quando uma leitura semanal do Codex em tempo real indica 100% de quota restante, o AIUsageWatch envia um pequeno pedido codex exec usando o início de sessão da CLI guardado nesse diretório. O seu objetivo é iniciar um período semanal que, de outro modo, pode permanecer inativo. Usa o modelo predefinido disponível do Codex e consome uma pequena parte da quota dessa conta.

Um ponto vermelho assinala a conta enquanto o pedido está em curso ou se falhar. O menu explica o estado e permite repetir a tentativa manualmente. A aplicação guarda a tentativa em memória para esse período semanal. As consultas repetidas não enviam mais pedidos para essa tentativa guardada; reiniciar a aplicação limpa a memória e pode resultar noutro pedido se a leitura em tempo real continuar nos 100%.

A fonte alternativa de transcrições históricas não envia pedidos de início. O pedido automático de início do Claude não está ativado na versão atual. Isto é distinto da leitura da utilização, e as preferências atuais não disponibilizam uma opção para ativar ou desativar o pedido de início do Codex.

Um valor é antigo, está em falta ou é inesperado

• Leitura guardada: a última leitura válida fica em cache no seu Mac e é restaurada ao iniciar a aplicação. O menu indica a sua antiguidade quando uma atualização falha.
• Limite de frequência ou falha de ligação: as novas tentativas são adiadas durante 15 minutos após um limite de frequência e 2 minutos após outros erros. Atualizar agora ignora esse intervalo de espera.
• Ligação ao Safari: verifique se a sessão do fornecedor correto está iniciada, reveja a autorização de acesso ao ficheiro de cookies e confirme que a sessão não é ambígua.
• Grok: execute a CLI para registar uma nova leitura de utilização. Um período expirado ou um registo mais antigo é apresentado 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 início de sessão pretendido. A fonte alternativa de transcrições pode mostrar informação mais antiga se o app-server estiver indisponível.

Os pontos de acesso e os dados dos fornecedores podem mudar. Uma leitura não garante que um fornecedor aceite o próximo pedido. Consulte a página da sua conta no próprio fornecedor quando um saldo ou uma reposição parecerem incorretos.

Definições locais e ligações aos fornecedores

As preferências e as leituras em cache ficam em ~/Library/Application Support/AiUsageWatch/. A aplicação não lê diretamente o Porta-chaves. As CLIs dos fornecedores gerem o seu próprio comportamento de início de sessão. Os leitores em tempo real contactam o fornecedor correspondente usando a sessão ou as credenciais existentes. Leia a política de privacidade para compreender a distinção entre o armazenamento local da aplicação, as ligações aos fornecedores e as mensagens de apoio.

Comunicar um problema

Contacte o apoio do AIUsageWatch com a versão da aplicação, a versão do macOS, o fornecedor, o estado da leitura e os passos que reproduzem o problema. Se usar o modo de diagnóstico --dump da aplicação, reveja os resultados antes de os enviar. Remova tokens, valores de cookies, caminhos privados de contas e qualquer outra informação sensível. Não envie ficheiros de credenciais.