VibeAround

O que é VibeAround?

VibeAround é uma interface de codificação para agentes locais que permite acessar agentes de IA para codificação suportados de qualquer lugar. Ela oferece duas superfícies principais — chat via plataformas IM populares e um terminal web baseado em navegador — respaldadas pelo mesmo workspace local, para que você continue trabalhando seja no celular, em um laptop de café ou em um shell de desktop.

O projeto também inclui um app desktop leve (construído com Tauri) para configuração e gerenciamento de serviços. Agentes e canais IM são implementados como plugins que podem ser ativados sob demanda, enquanto conectividade subjacente e comportamento de sessão são gerenciados por protocolos consistentes e túneis integrados.

Principais Recursos

• Chat com seu agente de IA local de qualquer IM: Envie DM para seu agente no Telegram, Slack, Feishu/Lark ou Discord para escrever código e executar comandos via interfaces de chat.
• Terminal web com compatibilidade tmux: Use um shell completo no navegador; no mobile, um pad de comandos na tela suporta acesso com um toque a teclas como ESC e entradas Ctrl/seta. Combine com tmux para que sessões permaneçam vivas após fechar o navegador.
• Handover bidirecional de sessão: Transfira uma sessão de codificação ativa entre terminal e IM usando /handover e /pickup, preservando o contexto completo.
• Troque de agente no meio da conversa: Altere qual agente suportado está controlando a sessão (ex.: /switch claude, /switch codex, /switch cursor) sem reiniciar o VibeAround.
• Prévia ao vivo via links temporários: Compartilhe Markdown/HTML renderizado de servidores de dev e abra os links do celular ou qualquer navegador.
• Assistente de configuração com um clique para túneis e credenciais: O assistente instala dependências de agentes, preenche credenciais de canais e seleciona um provedor de túnel, reduzindo configuração manual.

Como Usar o VibeAround

1. Compile e execute o projeto (para desenvolvimento local): cd src, depois bun install, bun run prebuild e bun run dev.
2. Inicie o app desktop: Na primeira execução, ele abre o assistente de configuração.
3. Escolha agentes e canais: Ative o(s) agente(s) que deseja usar e configure credenciais de canais IM conforme solicitado pelo assistente.
4. Configure túneis: O assistente seleciona um backend de túnel para que o terminal web e a prévia ao vivo sejam acessíveis via URLs públicas protegidas por token.
5. Comece a trabalhar: Abra o cliente IM para enviar DM ao seu agente para codificação via chat, ou use o terminal web em um navegador. Quando necessário, transfira uma sessão ativa entre superfícies com /handover e /pickup.

Pré-requisitos listados no repositório são Rust 1.82+, Node.js 20+ e Bun 1.1+; no macOS, também execute xcode-select --install.

Casos de Uso

• Codificação via IM em viagens: Mantenha o desenvolvimento em andamento no Telegram/Slack/Feishu/Discord enviando comandos e recebendo saída de código diretamente no chat.
• Trabalho em terminal em laptop emprestado: Abra o terminal web baseado em navegador em uma máquina de café; use tmux para que a sessão persista após fechar o navegador.
• Troca entre celular e terminal: Inicie uma sessão no terminal web, depois use comandos de handover para continuar no IM (ou vice-versa) com o mesmo contexto.
• Uso de agentes diferentes para tarefas distintas: Execute um agente no Telegram enquanto trabalha com outro no Slack, ou troque de agente no meio da conversa com os comandos /switch ... fornecidos.
• Compartilhamento rápido de prévia para validar UI/conteúdo: Publique Markdown/HTML renderizado ou saída de servidor de dev via links temporários e visualize no celular.

FAQ

• Quais agentes de IA para codificação o VibeAround suporta? O repositório lista suporte para Claude Code, Gemini CLI, Codex CLI, Cursor CLI, Kiro CLI e Qwen Code, com comunicação via stdio usando ACP (Agent Client Protocol).

• Como o VibeAround se conecta às plataformas IM? Cada canal IM roda como um plugin Node.js independente carregado sob demanda. Detalhes de autenticação variam por plataforma (ex.: tokens de bot, credenciais de app ou login por QR code), e o assistente de configuração ajuda a preenchê-los.

• O que significa “handover de sessão” na prática? Permite mover uma sessão de codificação ativa entre o terminal web e IM usando comandos (/handover e /pickup) preservando o contexto completo.

• As URLs do terminal web e prévia ao vivo exigem controle de acesso? Sim. O repositório afirma que as URLs expostas são protegidas por token: elas são acessíveis publicamente, mas só você pode abri-las.

• O tmux é obrigatório para persistência de sessão? A documentação diz que o terminal web pode ser combinado com tmux para que sessões permaneçam vivas após fechar o navegador.

Alternativas

• Fluxo de trabalho em terminal local usando um agente CLI diretamente: Você pode usar o CLI do agente no seu próprio terminal, mas não terá a integração com IM, a interface de terminal web ou o handover de sessão integrado entre chat e terminal.
• Assistentes de codificação com IA baseados na web: Assistentes baseados no navegador podem oferecer uma interface consistente de qualquer lugar, mas não igualam o foco do VibeAround em conectar processos de agentes locais e preservar o mesmo espaço de trabalho entre chat e terminal.
• Codificação baseada em chat via bots de plataforma (sem handover de sessão/terminal web): Abordagens com bots de IM podem trazer a saída do agente para o chat, mas podem não oferecer o mesmo handover bidirecional e experiência de terminal web descrita no VibeAround.
• Túnel genérico + seu próprio terminal web: Usar túnel e uma configuração de terminal no navegador pode aproximar o acesso remoto, mas você precisaria montar e manter o gerenciamento de agente/sessão sozinho, em vez de usar a arquitetura de plugin e comandos de handover do VibeAround.