Detecção sem configuração
O aplicativo desktop procura ferramentas e logins de provedores que já existem neste dispositivo. Ele pode começar sem conta OpenLimiter e sem copiar credenciais, enquanto toda leitura ausente ou incerta permanece visivelmente desconhecida.
O que o OpenLimiter faz
O OpenLimiter reúne todas as janelas de quota expostas por um provedor compatível, mostra quanto foi usado e quando ocorre o reset, e oferece orientação limitada de roteamento para você e seu agente de código. Ele é um medidor e conselheiro. Nunca gasta quota, altera um plano nem escolhe um provedor sem você.
Como a detecção funciona
Na inicialização, o aplicativo desktop faz uma varredura limitada em locais conhecidos. Ele não percorre o disco inteiro, não segue links simbólicos e não envia o resultado da detecção para lugar algum.
- O Windows verifica AppData Roaming e Local. O macOS verifica Application Support e pastas dos provedores no diretório pessoal. O Linux verifica locais XDG e pastas dos provedores no diretório pessoal.
- Cada provedor fica como
present,installed_logged_outouabsent. Quota desconhecida é separada da detecção e nunca vira zero. - Perfis locais distintos viram contas distintas. A interface expõe uma identidade opaca e nunca expõe token, identificador bruto de conta ou caminho de credencial.
- O token do provedor é lido novamente do arquivo original imediatamente antes de uma chamada ao provedor. Um login vencido orienta você a reabrir o CLI daquele provedor. O OpenLimiter nunca cria nem renova esse token.
- A varredura automática não lê o Keychain. Se uma ferramenta no macOS guardar o login somente ali, ela pode aparecer instalada, mas sem login. A entrada manual continua disponível.
Provedores e leituras compatíveis
O aplicativo desktop é compatível com cinco famílias de provedores. Cada linha abaixo nomeia a leitura e a fonte com clareza.
| provedor | o que informa | como é lido |
|---|---|---|
| Claude Code | Uso da sessão de cinco horas e uso de sete dias, com horários de reset. | O login OAuth local do Claude Code e o endpoint de uso da Anthropic. Os dados de statusline do Claude Code continuam como fallback. |
| Codex | A janela principal de quota, o percentual usado e seu reset quando o provedor o fornece. | O login local do Codex e um endpoint de uso não oficial da OpenAI. |
| Antigravity | O grupo de quota mais restritivo, o percentual usado e seu reset. | O login local do Antigravity e um endpoint de quota não oficial do Google. |
| OpenCode | A janela móvel de uso mais restritiva e sua contagem regressiva de reset. | Uma sessão existente do navegador e a leitura autenticada da página do workspace. |
| OpenRouter | Créditos usados sobre o total, incluindo o valor em dólares americanos e sem reset. | Uma chave fornecida por você e a API documentada de créditos do OpenRouter. |
Limite de privacidade
O modo local foi projetado para que o OpenLimiter possa aconselhar sem se tornar mais um detentor da identidade do provedor.
- A detecção lê somente arquivos limitados em locais conhecidos dos provedores neste dispositivo.
- Uma credencial do provedor é enviada somente ao endpoint do provedor que a emitiu. Ela nunca é enviada ao OpenLimiter nem a outro provedor.
- O modo local não envia telemetria, snapshots de quota, diagnósticos, prompts nem identificadores ao OpenLimiter.
- O OpenLimiter somente aconselha. Ele não envia prompts, altera assinaturas nem roteia trabalho por conta própria.
- O OpenLimiter nunca cria, renova ou repara silenciosamente um token de provedor.
Quando um provedor mostra desconhecido
Desconhecido significa que nenhuma leitura atual passou em todas as verificações de contrato. Não significa uso zero nem prova que a assinatura está vazia.
- 1Abra o CLI do provedor e confirme que ele está instalado e autenticado. Se a mensagem disser que o login venceu, feche e reabra esse CLI para que ele renove a própria credencial.
- 2Volte ao OpenLimiter, repita a detecção dos provedores e solicite uma atualização para essa conta.
- 3Se o provedor limitou chamadas recentemente, mantenha a leitura em cache e aguarde o horário da nova tentativa. Cliques repetidos não ignoram o recuo do provedor.
- 4Verifique o rótulo da fonte. Endpoints privados e páginas autenticadas podem mudar sem aviso. Uma mudança de contrato permanece desconhecida de propósito até que o conector seja atualizado.
- 5Use a entrada manual quando a coleta automática estiver indisponível. Um provedor bloqueado não desativa os demais.