VibeAround

¿Qué es VibeAround?

VibeAround es una interfaz de codificación para agentes locales que te permite acceder a agentes de IA compatibles desde cualquier lugar. Ofrece dos superficies principales: chat a través de plataformas IM populares y una terminal web basada en navegador, respaldadas por el mismo espacio de trabajo local para que puedas seguir trabajando ya sea en tu teléfono, en un portátil de café o en un shell de escritorio.

El proyecto también incluye una app de escritorio ligera (construida con Tauri) para configuración y gestión de servicios. Los agentes y canales IM se implementan como plugins que se pueden activar a demanda, mientras que la conectividad subyacente y el comportamiento de sesiones se manejan mediante protocolos consistentes y túneles integrados.

Características principales

• Chatea con tu agente de IA local desde cualquier IM: Envía DM a tu agente en Telegram, Slack, Feishu/Lark o Discord para escribir código y ejecutar comandos a través de interfaces de chat.
• Terminal web con compatibilidad tmux: Usa un shell completo en el navegador; en móvil, un pad de comandos en pantalla permite acceso de un toque a teclas como ESC y entradas Ctrl/flecha. Combínalo con tmux para que las sesiones permanezcan vivas tras cerrar el navegador.
• Traspaso bidireccional de sesiones: Mueve una sesión de codificación en vivo entre terminal e IM con /handover y /pickup, preservando el contexto completo.
• Cambia de agente en medio de la conversación: Cambia qué agente compatible dirige la sesión (p. ej., /switch claude, /switch codex, /switch cursor) sin reiniciar VibeAround.
• Vista previa en vivo vía enlaces de corta duración: Comparte Markdown/HTML renderizado de servidores de desarrollo y abre los enlaces desde un teléfono o cualquier navegador.
• Asistente de configuración de un clic para túneles y credenciales: El asistente instala dependencias de agentes, completa credenciales de canales y selecciona un proveedor de túnel, reduciendo la configuración manual.

Cómo usar VibeAround

1. Compila y ejecuta el proyecto (para desarrollo local): cd src, luego bun install, bun run prebuild y bun run dev.
2. Lanza la app de escritorio: En el primer lanzamiento, abre el asistente de configuración.
3. Elige agentes y canales: Activa el/los agente(s) que quieras usar y configura credenciales de canales IM según indique el asistente.
4. Configura el túnel: El asistente selecciona un backend de túnel para que la terminal web y la vista previa en vivo sean accesibles a través de URLs públicas con puerta de tokens.
5. Empieza a trabajar: Abre el cliente IM para enviar DM a tu agente para codificación basada en chat, o usa la terminal web en un navegador. Cuando sea necesario, transfiere una sesión en vivo entre superficies con /handover y /pickup.

Los requisitos previos listados en el repositorio son Rust 1.82+, Node.js 20+ y Bun 1.1+; en macOS también debes ejecutar xcode-select --install.

Casos de uso

• Codificación desde un IM mientras viajas: Mantén el desarrollo en marcha desde Telegram/Slack/Feishu/Discord enviando comandos y recibiendo salida de código directamente en el chat.
• Trabajo en terminal en un portátil prestado: Abre la terminal web basada en navegador en una máquina de café; usa tmux para que la sesión persista tras cerrar el navegador.
• Cambio entre teléfono y terminal: Inicia una sesión en la terminal web, luego usa comandos de traspaso para continuar desde un IM (o viceversa) con el mismo contexto.
• Uso de diferentes agentes para tareas distintas: Ejecuta un agente en Telegram mientras trabajas con otro en Slack, o cambia de agente en medio de la conversación con los comandos /switch ... proporcionados.
• Compartir una vista previa rápida para validar UI/contenido: Publica Markdown/HTML renderizado o salida de servidor de desarrollo vía enlaces de corta duración y visualízalo en tu teléfono.

Preguntas frecuentes

• ¿Qué agentes de IA de codificación soporta VibeAround? El repositorio lista soporte para Claude Code, Gemini CLI, Codex CLI, Cursor CLI, Kiro CLI y Qwen Code, con comunicación sobre stdio usando ACP (Agent Client Protocol).

• ¿Cómo se conecta VibeAround a plataformas IM? Cada canal IM se ejecuta como un plugin Node.js independiente cargado a demanda. Los detalles de autenticación varían por plataforma (p. ej., tokens de bot, credenciales de app o login por QR), y el asistente de configuración ayuda a completarlos.

• ¿Qué significa “traspaso de sesión” en la práctica? Permite mover una sesión de codificación en vivo entre la terminal web e IM usando comandos (/handover y /pickup) preservando el contexto completo.

• ¿Las URLs de terminal web y vista previa en vivo requieren control de acceso? Sí. El repositorio indica que las URLs expuestas tienen puerta de tokens: son accesibles públicamente, pero solo tú puedes abrirlas.

• ¿Es tmux requerido para la persistencia de sesiones? La documentación dice que la terminal web se puede combinar con tmux para que las sesiones permanezcan vivas tras cerrar el navegador.

Alternativas

• Flujo de trabajo en terminal local usando un agente CLI directamente: Puedes usar el CLI del agente en tu propia terminal, pero no obtendrás la integración con IM, la interfaz de terminal web ni el traspaso de sesión integrado entre chat y terminal.
• Asistentes de codificación con IA basados en web: Los asistentes basados en navegador pueden ofrecer una interfaz consistente desde cualquier lugar, pero no igualarán el enfoque de VibeAround en conectar procesos de agentes locales y preservar el mismo espacio de trabajo entre chat y terminal.
• Codificación basada en chat a través de bots de plataforma (sin traspaso de sesión/terminal web): Los enfoques de bots IM pueden llevar la salida del agente al chat, pero pueden no proporcionar el mismo traspaso bidireccional y experiencia de terminal web descrita en VibeAround.
• Túnel genérico + tu propia terminal web: Usar túneles y una configuración de terminal en navegador puede aproximar el acceso remoto, pero tendrías que ensamblar y mantener la gestión de agentes/sesiones tú mismo en lugar de usar la arquitectura de plugins y comandos de traspaso de VibeAround.