Controllare agenti AI da un messenger con botmux
Immagina uno scenario familiare. Hai avviato un refactoring pesante con Claude Code o Codex sul tuo workstation, poi ti sei allontanato per un tè o sei tornato a casa. Cinque minuti dopo, la CLI si blocca in attesa di conferma per eliminare un file. Sei seduto sui mezzi pubblici con lo smartphone, e il processo è in stallo.
Per chi usa attivamente gli assistenti AI da console, lo sviluppatore deepcoldy ha scritto l'utility botmux. Trasforma il messenger Feishu (noto come Lark fuori dalla Cina) in un pannello di controllo per due dozzine di agenti da console.
Qual è l'idea centrale del progetto
La maggior parte delle piattaforme per integrare l'AI nelle chat prende la strada più complessa. Gli sviluppatori prendono l'SDK del modello necessario, costruiscono un wrapper sopra, reimplementano le chiamate di funzione, la memoria e la gestione dei file. Il risultato è una versione ridotta di un vero agente da console.
botmux adotta un approccio diverso. Lo strumento non tenta di essere un agente AI o di gestire il contesto attraverso il proprio codice. Invece, un servizio in background avvia un processo completo dell'utility da console sul tuo server o workstation. Ogni nuovo argomento o dialogo nella chat crea una sessione separata, con gli output trasmessi al messenger come schede interattive.
Questa architettura offre un bel vantaggio. Quando gli sviluppatori di Claude Code, Codex, Gemini CLI o Cursor rilasciano aggiornamenti con nuovi comandi o supporto per server MCP, botmux non ha bisogno di riscritture. Lavori con l'applicazione console originale con tutte le sue funzionalità intatte.
Quattro funzionalità interessanti
Di seguito i dettagli su come è strutturato il lavoro con gli agenti nella chat.
Schede in streaming e trasferimento del controllo
L'output della CLI viene trasmesso direttamente nel messaggio del messenger. Vedi il testo che si aggiorna e puoi controllare il processo attraverso i pulsanti delle schede. Visualizzare screenshot del terminale, comprimere log lunghi e riavviare una sessione bloccata sono tutte funzionalità disponibili.
Se i pulsanti interattivi non sono sufficienti, botmux fornisce un link al terminale web. Puoi lavorare direttamente dal tuo smartphone, con una tastiera speciale visualizzata sullo schermo con pulsanti per Esc, Ctrl+C e frecce di navigazione.
Lavoro di squadra tra modelli diversi
Puoi aggiungere più bot collegati a diverse utility da console a una singola chat di gruppo. Per esempio, collega un bot a Claude Code e un altro a Codex.
Quando menzioni un bot tramite @, il messaggio va a quell'agente specifico. Questo è utile per il cross-review del codice. Puoi chiedere a due modelli diversi di analizzare la stessa pull request, e inizieranno a dibattere tra loro direttamente nel thread di discussione.
Migrazione delle sessioni tra dispositivi
Supponiamo che tu abbia avviato una sessione localmente nel familiare tmux. Usando il comando /adopt nella chat, puoi assumere il controllo di quella sessione direttamente sul telefono.
Se la discussione di un task è andata troppo per le lunghe e deve essere condivisa con tutto il team, il comando /relay trasferisce l'intero processo insieme alla memoria accumulata e al contesto nella chat di gruppo condivisa.
Automazione e trigger esterni
L'utility supporta scheduling e webhook. Puoi configurare il parsing periodico di alert o la generazione di report pianificati descrivendo il task in linguaggio naturale. I sistemi esterni possono attivare gli agenti attraverso richieste HTTP standard.
Come funziona internamente
Il progetto è scritto in TypeScript e gira su Node.js versione 22 o successiva. Internamente utilizza un'architettura adapter per supportare diverse CLI:
claude-codecodexgeminicursoropencodecopilot
Le utility locali vengono eseguite con isolamento del processo. Puoi sempre connetterti a un agente in esecuzione direttamente tramite tmux attach se sei al workstation.
L'installazione e la configurazione iniziale sono ridotte al minimo:
npm install -g botmux
botmux setup
botmux start
La procedura guidata interattiva botmux setup aiuta a collegare il tuo account Feishu tramite codice QR, configura automaticamente i permessi dell'app nella dashboard aziendale e avvia la configurazione base.
Vale la pena provarlo
Il progetto ha raccolto quasi 900 stelle su GitHub, e non senza ragione. Il codice è ben strutturato, e l'idea di usare una vera CLI invece di scrivere un altro SDK sembra sensata.
Il principale svantaggio dell'utility è il suo forte accoppiamento con il messenger Feishu/Lark. Se il tuo team lavora su Slack o Telegram, non potrai usare lo strumento pronto all'uso. Dovrai either scrivere il tuo bridge o portare gli adapter dal repository.
Tuttavia, se lavori su Lark e usi attivamente agenti AI da terminale, botmux ti libera dalla necessità di restare costantemente davanti al monitor. Dai un'occhiata al repository del progetto su GitHub per esplorare la lista degli adapter supportati o guardare le soluzioni architetturali.
Progetti correlati