O Agente Não Consegue Conectar
- Verifique sua conexão com a internet
- Confirme se o relay está acessível:
curl https://coding.btelo.com/ping - Verifique se um firewall está bloqueando conexões WebSocket de saída (porta 443)
O App iOS Não Encontra o Agente
- Certifique-se de que o agente está em execução e mostra Cloud: running
- O QR code / link de conexão pode ter expirado — pressione r na TUI para atualizar o QR code e escaneie novamente
- Se você reconfigurou o conector (pressione c), precisa parear novamente escaneando o novo QR code
Nenhum Provedor de IA Encontrado
Instale pelo menos um provedor:
npm install -g @anthropic-ai/claude-code
Certifique-se de que a CLI está no seu PATH — execute claude --version para verificar.
Conflito de Porta
O agente usa a porta 24385 por padrão. Se estiver ocupada, ele escolhe uma porta aleatória automaticamente. Defina uma porta customizada:
PORT=8080 vibe-remote
Forçar atualização para a versão mais recente
Se o agente estiver preso em uma versão antiga ou a atualização automática não foi aplicada, execute novamente o comando de instalação para obter a versão mais recente:
macOS / Linux
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell)
irm https://coding.btelo.com/install.ps1 | iex
Após concluir, reinicie o agente para carregar o novo binário.
Logs
Os logs aparecem no viewport da TUI. No modo headless, os logs vão para o stdout. Os arquivos de log são armazenados em ~/.vibe-remote/logs/.
Obtendo Ajuda
Abra uma issue em github.com/btelolabs/btelo-coding-release/issues.