Conexões
Todo provedor mostra duas coisas: um chip nomeando de onde vieram os números dele, e, abaixo, um estado tirado de um vocabulário único que o produto inteiro compartilha. Esta página nomeia cada estado dele, diz claramente o que Import only significa, e diz o que muda quando uma conexão ao vivo passa a existir.
O chip num provedor hoje
Um parser existir não é uma conexão, então nenhum cartão é rotulado como conectado com base num só. Todo provedor, em vez disso, carrega um chip nomeando como os números dele realmente chegaram a este dispositivo: um dos três abaixo antes de existir uma conexão ao vivo, ou Conectado assim que você vincular esse provedor a partir do aplicativo de desktop.
| chip | provedores | significado |
|---|---|---|
Local CLI | Claude, Codex, Gemini CLI, Antigravity, Grok, Kimi, OpenRouter | A tool already on this machine holds the login, and OpenLimiter reads its own quota from that, or from what that tool already wrote. |
Import only | OpenCode | O formato do payload é interpretado. Nada aqui entra numa conta ou busca isso, então você fornece o documento. |
Manual | Entradas manuais | Números que você mesmo mantém. Nada é lido de uma conta. |
O vocabulário completo de conexão
Abaixo dos três chips há um vocabulário maior: treze estados nomeados, um módulo no pacote core em que o produto inteiro é construído, cada um com uma frase simples em vez de uma linha de log. Ele existe para que o estado de uma conexão seja um valor que toda superfície lê da mesma forma, nunca uma frase que cada uma é livre para inventar por conta própria.
| estado | significado |
|---|---|
NOT_CONFIGURED | Não conectado. |
DETECTED | Encontrado nesta máquina, mas ainda não coletando. |
NEEDS_AUTH | Esperando uma credencial. |
READY_TO_ENABLE | Pronto para começar a coletar. |
CONNECTING | Conectando. |
CONNECTED | Conectado e coletando. |
DEGRADED | O provedor está recusando leituras por enquanto. |
STALE | A última leitura é mais antiga do que deveria. |
AUTH_EXPIRED | A credencial guardada parou de funcionar. |
IMPORT_ONLY | Só lê o que você importa. Nada é coletado automaticamente. |
MANUAL | Mostra o plano que você mesmo digitou. |
UNSUPPORTED | Ainda não existe uma fonte automática segura para este produto. |
ERROR | Esta conexão falhou e precisa de uma olhada. |
IMPORT_ONLY,MANUALeUNSUPPORTEDsão declarados em vez de tentados, por design: o produto os afirma diretamente, e nada que aconteça depois, uma resposta, uma falha, um tempo esgotado, pode promover um deles aCONNECTEDsilenciosamente. Só o próprio OpenLimiter afirmando o contrário tira uma conexão de um deles.- O resto nomeia um ciclo de vida pelo qual um leitor ao vivo faria uma conexão passar: encontrado mas ainda não coletando, esperando uma credencial, conectando, conectado, e, quando algo dá errado, degradado, desatualizado, expirado, ou precisando de uma olhada.
O que esta página não está afirmando
Os treze estados não aparecem em todas as telas. O web app e a ferramenta de linha de comando mostram o vocabulário simples de três chips quando não há um leitor ao vivo. A linha de comando pode solicitar uma atualização ao vivo quando existe um leitor configurado. Os treze estados são reais e testados no pacote central, e a tela Connections do aplicativo desktop os mostra conforme a conexão avança pelo ciclo de vida.
O que uma conexão ao vivo muda
Nada nesta página é uma data ou uma promessa. O web app e a ferramenta de linha de comando usam os três chips acima quando não há um leitor ao vivo, enquanto um leitor configurado na linha de comando pode atualizar um provedor. Quando um provedor tem um leitor real, sua descrição honesta é o estado entre os treze que se encaixa naquele momento: detectado, aguardando uma credencial, conectando, conectado ou, quando algo dá errado, degradado, desatualizado ou precisando de atenção.
Nem todo provedor tem esse leitor hoje; a própria tela de Conexões do aplicativo de desktop é onde um leitor ao vivo aparece primeiro. Veja o roadmap para o que está planejado e o que não está, e provedores suportados para o que cada connector consegue realmente fazer agora.