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 — o app de desktop está aberto, ou o agente CLI exibe Cloud: running.
- O QR code / link de conexão pode ter expirado — atualize-o (reabra o painel Conectar no app de desktop, ou pressione r na TUI do CLI) e escaneie novamente.
- Se você reconfigurou o conector, pare novamente escaneando o novo QR code.
Nenhum Provedor de IA Encontrado
Instale pelo menos um provedor na máquina do agente:
npm install -g @anthropic-ai/claude-code
Certifique-se de que a CLI está no seu PATH — execute claude --version para verificar. No app de desktop, use Configurações → Guia de configuração → Reverificar para detectar provedores novamente. Ou escolha o Btelo Agent embutido com sua própria chave DeepSeek / MiniMax.
Conflito de Porta
O agente usa a porta 24385 por padrão. Se estiver ocupada, ele escolhe uma porta aleatória automaticamente. Para definir uma porta customizada no agente CLI:
PORT=8080 vibe-remote
Forçar Atualização para a Versão Mais Recente
App de desktop: abra Configurações → Verificar atualizações, depois Reiniciar e atualizar. Se ainda estiver travado, baixe a versão mais recente na página de download e reinstale sobre o app existente.
Agente CLI: se 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:
Linux / macOS
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
No app de desktop, os logs estão disponíveis na janela do app. Para o agente CLI, os logs aparecem no viewport da TUI (ou no stdout no modo headless). Os arquivos de log são armazenados em ~/.vibe-remote/logs/.
Obtendo Ajuda
Abra uma issue em github.com/btelolabs/btelo-coding-release/issues.