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
Não que os treze estejam na tela em todo lugar. O web app e a ferramenta de linha de comando ainda renderizam o vocabulário mais simples, de três chips, acima, porque nenhum dos dois lê um provedor ao vivo sozinho. Os treze estados são reais e testados no pacote core em que este produto é construído, e nomeiam o ciclo de vida geral que uma conexão segue onde quer que exista um leitor ao vivo, que hoje é a própria tela de Conexões do aplicativo de desktop, e não esta página.
O que uma conexão ao vivo muda
Nada nesta página é uma data ou uma promessa para o web app ou a ferramenta de linha de comando, que permanecem nos três chips acima porque nenhum dos dois lê um provedor ao vivo. Quando um provedor ganha um leitor de verdade, a descrição honesta dele deixa de ser um chip fixo e passa a ser qualquer um dos treze estados acima que realmente se encaixe naquele momento: detectado, esperando uma credencial, conectando, conectado, ou, quando algo dá errado, degradado, desatualizado, ou precisando de uma olhada. Esse é o motivo de nomear todo o vocabulário aqui, para que a frase que uma pessoa lê não mude enquanto o estado por baixo dela se move.
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.