Quando Usar o CLI
O agente CLI executa o Btelo Coding a partir do terminal. É a escolha certa quando:
- Você está no Linux — não há app de desktop para Linux.
- Você está rodando em um servidor headless ou VPS sem ambiente de desktop.
- Você quer automatizar ou usar scripts para iniciar o agente.
No Mac e Windows, o app de desktop é a forma recomendada de executar o agente — um único download, configuração guiada e sem terminal. Use o CLI nesses sistemas apenas se você especificamente quiser um fluxo de trabalho via terminal.
Instalação
Linux / macOS:
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell):
irm https://coding.btelo.com/install.ps1 | iex
Iniciar o Agente
vibe-remote
A TUI aparece. Pressione c para definir o nome e a senha do seu conector. O agente se conecta automaticamente ao relay na nuvem e exibe um QR code de pareamento no Dashboard. Escaneie-o pelo app iOS para conectar.
Atalhos da TUI (aba Dashboard):
| Tecla | Ação |
|---|---|
| c | Configuração — definir nome e senha do conector |
| w | Trocar servidor relay |
| d | Gerenciar dispositivos conectados |
| r | Atualizar QR code |
| h | Mostrar / ocultar QR code |
| m | Alternar papel do QR (Admin / Membro) |
| y | Copiar link do QR para a área de transferência |
| t | Ajuda para Desktop |
| i | QR de instalação (link da App Store) |
| u | Reiniciar após atualização |
| s | Parar o servidor |
| q | Sair da TUI |
| 1/2/3 | Alternar abas (Dashboard / Logs / Install) |
Aba Logs: g ir para o topo, G ir para o final, x limpar logs.
Modal de Dispositivos: k remover dispositivo selecionado, r atualizar lista.
Modo Headless
A TUI interativa não está disponível no Windows e não é adequada para servidores headless. Inicie sem TUI:
vibe-remote --headless --connector myconnector --password mypassword
Atualizar
vibe-remote update
Após o download da atualização, pressione u na TUI para reiniciar na nova versão sem derrubar sua conexão.
Referência de CLI
vibe-remote Iniciar TUI (padrão)
vibe-remote --headless Iniciar sem TUI
vibe-remote client Conectar a um agente remoto (modo reverso)
vibe-remote relay Executar como servidor relay
vibe-remote delete-connector Excluir o conector salvo
vibe-remote update Atualizar para a versão mais recente
vibe-remote version Mostrar versão
vibe-remote help Mostrar ajuda