Gestire numerosi terminali può diventare rapidamente complicato, soprattutto quando si lavora con server remoti, sessioni SSH, ambienti di sviluppo e strumenti per la programmazione assistita dall’intelligenza artificiale. btmux affronta questo scenario proponendo un terminal manager accessibile direttamente dal browser e costruito attorno a un’interfaccia fortemente ispirata a tmux.
Il progetto utilizza ghostty-web per fornire l’esperienza terminale all’interno del browser e adotta un’architettura client-server. Questo significa che lo stato delle sessioni rimane sul server anche quando il browser viene chiuso o la connessione viene interrotta. È quindi possibile riconnettersi successivamente, anche utilizzando più schede o browser differenti, senza perdere le sessioni di lavoro.
L’interazione riprende molto da vicino le combinazioni di tasti tradizionali di tmux. Il prefisso può essere utilizzato per creare nuovi pannelli, modificare la disposizione delle finestre, spostarsi tra gli split o effettuare operazioni sulle sessioni. La combinazione <prefix> + %, ad esempio, permette di creare uno split verticale, mentre <prefix> + " crea una divisione orizzontale.
btmux non si limita però alla gestione dei terminali. L’interfaccia comprende un albero delle sessioni ricercabile, anteprime in tempo reale delle finestre e degli agenti, un browser dei file, una sezione dedicata a Git e un visualizzatore dei processi. Sono inoltre disponibili lo zoom dei pannelli, lo scambio dei pane e diversi layout preimpostati.
Il progetto è distribuito come singolo binario statico che include anche le risorse necessarie all’interfaccia e alcuni font. Questo approccio semplifica notevolmente la distribuzione su server personali, workstation e ambienti dedicati allo sviluppo.
Temi, automazione e integrazione con gli agenti AI
Uno degli aspetti più interessanti di btmux riguarda la possibilità di personalizzare profondamente l’ambiente. Il programma crea al primo avvio il file ~/.config/btmux/config.toml, oppure utilizza la posizione definita da $XDG_CONFIG_HOME. Molte modifiche vengono applicate automaticamente senza dover riavviare il server.
La configurazione può inoltre essere gestita direttamente dall’interfaccia tramite il comando config, richiamabile con il prefisso di tmux. Il sistema permette di intervenire su temi, profili, font, opzioni del terminale, sfondi e altre impostazioni dell’interfaccia.
Particolarmente interessante è il supporto per gli schemi cromatici Base16 e Base24 e per gli effetti WebGL. Gli sfondi possono essere generati proceduralmente utilizzando gli shader Radiant, mentre temi e altre risorse possono essere ricaricati a caldo. L’ambiente può quindi essere adattato sia a un utilizzo minimale sia a configurazioni graficamente più elaborate.
btmux integra anche una serie di funzioni pensate per attività di sviluppo moderne:
- API REST e server MCP per l’automazione;
- notifiche provenienti da Claude Code, Codex e Gemini CLI;
- statistiche dell’host;
- visualizzazione dello stato degli agenti di programmazione;
- overlay LaTeX per visualizzare formule matematiche stampate all’interno di un pannello;
- navigazione opzionale con stile vi;
- gestione personalizzabile delle scorciatoie in stile tmux.
L’API REST e il server MCP utilizzano lo stesso indirizzo del servizio web e condividono il sistema di autenticazione tramite token. Questo permette di collegare strumenti esterni e agenti software alle sessioni gestite da btmux, aprendo possibilità interessanti per l’automazione delle attività di sviluppo e amministrazione.
L’avvio rimane estremamente semplice: eseguendo btmux il server viene avviato e il browser viene aperto automaticamente. Con btmux --no-browser è invece possibile avviare il servizio senza aprire una nuova scheda. Sono disponibili anche comandi dedicati alla visualizzazione della versione, alla generazione della configurazione predefinita e alla creazione degli script di completamento per shell come Zsh.
Per chi utilizza già tmux ma preferisce un’interfaccia accessibile dal browser, btmux propone quindi un approccio particolarmente interessante, combinando sessioni persistenti, gestione dei terminali, strumenti per lo sviluppo e funzioni di automazione in un’unica applicazione.