VibeAround

Cos'è VibeAround?

VibeAround è un'interfaccia di coding per agenti locali che ti permette di raggiungere agenti di coding AI supportati da ovunque. Fornisce due superfici principali—chat tramite piattaforme IM popolari e un terminale web basato su browser—supportate dallo stesso workspace locale, così puoi continuare a lavorare sia che tu sia sul telefono, su un laptop in un caffè o in un ambiente desktop.

Il progetto include anche un'app desktop leggera (costruita con Tauri) per configurazione e gestione dei servizi. Agenti e canali IM sono implementati come plugin attivabili su richiesta, mentre connettività sottostante e comportamento delle sessioni sono gestiti tramite protocolli consistenti e tunneling integrato.

Caratteristiche Principali

• Chatta con il tuo agente AI locale da qualsiasi IM: Invia un DM al tuo agente su Telegram, Slack, Feishu/Lark o Discord per scrivere codice ed eseguire comandi tramite interfacce chat.
• Terminale web con compatibilità tmux: Usa un shell completo nel browser; su mobile, un pad comandi sullo schermo supporta accesso one-tap a tasti come ESC e input Ctrl/freccia. Abbina con tmux così le sessioni rimangono attive dopo la chiusura del browser.
• Handover bidirezionale delle sessioni: Sposta una sessione di coding live tra terminale e IM usando /handover e /pickup, preservando il contesto completo.
• Cambia agente a metà conversazione: Cambia quale agente supportato guida la sessione (es. /switch claude, /switch codex, /switch cursor) senza riavviare VibeAround.
• Anteprima live tramite link a breve durata: Condividi Markdown/HTML renderizzato da server di sviluppo e apri i link da telefono o qualsiasi browser.
• Wizard di setup one-click per tunnel e credenziali: Il wizard installa dipendenze degli agenti, compila credenziali dei canali e seleziona un provider di tunnel, riducendo la configurazione manuale.

Come Usare VibeAround

1. Compila ed esegui il progetto (per sviluppo locale): cd src, poi bun install, bun run prebuild e bun run dev.
2. Avvia l'app desktop: Al primo avvio, apre il wizard di setup.
3. Scegli agenti e canali: Attiva l'agente(i) che vuoi usare e configura le credenziali dei canali IM come richiesto dal wizard.
4. Configura il tunneling: Il wizard seleziona un backend di tunnel così il terminale web e l'anteprima live siano accessibili tramite URL pubblici protetti da token.
5. Inizia a lavorare: Apri il client IM per inviare DM al tuo agente per coding basato su chat, o usa il terminale web in un browser. Quando serve, passa una sessione live tra superfici con /handover e /pickup.

Prerequisiti elencati nel repository sono Rust 1.82+, Node.js 20+ e Bun 1.1+; su macOS devi anche eseguire xcode-select --install.

Casi d'Uso

• Coding da IM mentre viaggi: Continua lo sviluppo da Telegram/Slack/Feishu/Discord inviando comandi e ricevendo output di coding direttamente in chat.
• Lavoro terminale su un laptop preso in prestito: Apri il terminale web basato su browser su una macchina in un caffè; usa tmux così la sessione persiste dopo la chiusura del browser.
• Passaggio tra telefono e terminale: Inizia una sessione nel terminale web, poi usa i comandi di handover per continuare da un IM (o viceversa) con lo stesso contesto.
• Usa agenti diversi per task diversi: Esegui un agente su Telegram mentre lavori con un altro su Slack, o cambia agenti a metà conversazione con i comandi /switch ... forniti.
• Condividi un'anteprima rapida per validare UI/contenuti: Pubblica Markdown/HTML renderizzato o output di dev-server tramite link a breve durata e visualizzalo sul telefono.

FAQ

• Quali agenti di coding AI supporta VibeAround? Il repository elenca supporto per Claude Code, Gemini CLI, Codex CLI, Cursor CLI, Kiro CLI e Qwen Code, con comunicazione gestita su stdio usando ACP (Agent Client Protocol).

• Come si connette VibeAround alle piattaforme IM? Ogni canale IM gira come plugin Node.js standalone caricato su richiesta. I dettagli di autenticazione variano per piattaforma (es. token bot, credenziali app o login QR code), e il wizard di setup aiuta a compilarli.

• Cosa significa “handover di sessione” in pratica? Ti permette di spostare una sessione di coding live tra terminale web e IM usando comandi (/handover e /pickup) preservando il contesto completo.

• Le URL del terminale web e anteprima live richiedono controllo di accesso? Sì. Il repository specifica che le URL esposte sono protette da token: sono raggiungibili pubblicamente, ma solo tu puoi aprirle.

• Tmux è richiesto per la persistenza delle sessioni? La documentazione dice che il terminale web può essere abbinato a tmux così le sessioni rimangono attive dopo la chiusura del browser.

Alternative

• Flusso di lavoro con terminale locale usando un agente CLI direttamente: Puoi usare l'agente CLI nel tuo terminale, ma non avrai l'integrazione IM, l'interfaccia web-terminale o il handover di sessione integrato tra chat e terminale.
• Assistenti di coding AI basati sul web: Gli assistenti browser-based offrono un'interfaccia coerente da ovunque, ma non eguagliano il focus di VibeAround sulla connessione a processi di agenti locali e la preservazione dello stesso workspace tra chat e terminale.
• Coding basato su chat tramite bot di piattaforma (senza handover di sessione/terminale web): Gli approcci con bot IM portano l'output dell'agente in chat, ma potrebbero non offrire lo stesso handover bidirezionale e l'esperienza del terminale web descritta in VibeAround.
• Tunneling generico + tuo terminale web: Usare tunneling e un setup terminale-in-browser può approssimare l'accesso remoto, ma dovresti assemblare e mantenere tu stesso la gestione agente/sessione invece di usare l'architettura plugin e i comandi di handover di VibeAround.