Come eseguire un terminale di lavoro completo con agenti AI direttamente nel browser

A volte devi correggere rapidamente un servizio andato in crash da un tablet mentre sei in movimento o controllare i log su un laptop che non ha le tue solite chiavi SSH configurate. Di solito questo significa sopportare terminali mobile, inciampare su input da tastiera poco maneggevoli e ristabilire sessioni cadute quando la connessione si è interrotta.

Recentemente mi sono imbattuto in Tabminal. Lo sviluppatore ha creato un terminale web che risolve due problemi contemporaneamente: mantenere sessioni server persistenti combinando l'accesso shell tradizionale con il protocollo ACP per lavorare con agenti AI autonomi.

Cosa può fare Tabminal

In sostanza, è uno spazio di lavoro completo nel tuo browser. Il backend viene eseguito sulla tua macchina o server, e ti connetti ad esso tramite l'interfaccia web o l'app PWA.

Funzionalità principali:

• Le sessioni non muoiono quando chiudi la scheda, aggiorni la pagina o passi da Wi-Fi a dati mobili.
• Editor di file integrato basato su Monaco (motore di VS Code) con evidenziazione della sintassi e anteprima delle immagini.
• Supporto nativo ACP (Agent Client Protocol) per lanciare assistenti autonomi come Claude Code, Gemini CLI o Codex.
• Gestisci un cluster di più server in una singola finestra con diritti di accesso separati.

Lavorare con agenti AI tramite ACP

L'integrazione AI qui va oltre una semplice barra laterale di chat accanto alla console. Il progetto supporta la specifica ACP, quindi l'agente opera in un contesto isolato e mostra le sue azioni direttamente nell'interfaccia:

• Le chiamate agli strumenti e l'esecuzione dei comandi vengono mostrate in tempo reale.
• Le modifiche al codice vengono visualizzate come blocchi diff chiari.
• C'è un pulsante "Entra" che ti porta direttamente nel terminale in esecuzione dell'agente se hai bisogno di prendere il controllo manualmente.
• Lo stato del dialogo, i piani di esecuzione e le trascrizioni vengono preservati tra un ricaricamento della pagina e l'altro.

Se le utility CLI di Anthropic, Google o OpenAI sono installate sul server, Tabminal le rileva automaticamente nei percorsi di sistema.

Oltre agli agenti complessi, c'è anche un semplice assistente integrato. Se digiti un comando con il simbolo # all'inizio di una riga, il server invia una richiesta a OpenAI o OpenRouter, tenendo conto della cronologia recente della shell. Quando un comando va in crash con un errore, il sistema suggerirà una correzione autonomamente.

Multi-Host e interfaccia mobile

Un dettaglio architetturale interessante: una singola istanza di Tabminal in esecuzione può fungere da hub centrale. Nella barra laterale, aggiungi altri server che hanno anche il backend del progetto in esecuzione. Il registro degli host viene salvato sul server principale e l'autorizzazione funziona individualmente per ogni nodo.

Vale la pena menzionare separatamente l'adattabilità. Di solito, i terminali web sugli smartphone diventano un incubo a causa della tastiera su schermo e dei tasti Ctrl, Alt o Esc mancanti. In Tabminal, il pannello virtuale viene posizionato proprio sopra la tastiera e l'interfaccia può collassare in una vista compatta rispettando le aree sicure dello schermo (Safe Area su iOS).

Architettura e sicurezza

Sotto il cofano, il progetto usa uno stack classico: Node.js versione 22 o superiore, il framework Koa, l'emulatore node-pty e WebSockets. Il lato client è scritto in JavaScript vanilla senza framework pesanti e la libreria xterm.js gestisce il rendering della console.

Importante: Tabminal dà accesso diretto al file system e all'esecuzione di comandi con i diritti dell'utente che esegue il processo. Non esporre mai la sua porta a internet pubblica senza protezione. Per l'accesso remoto, l'autore consiglia direttamente reti overlay isolate come Tailscale o il tunneling con autenticazione tramite Cloudflare Access. All'avvio, il flag --accept-terms è obbligatorio, altrimenti il processo uscirà con un errore.

Avvio rapido

Il modo più semplice per lanciare l'utility è tramite npx:

npx tabminal --accept-terms

Se prevedi di usare l'assistente integrato, passa la tua chiave OpenAI o OpenRouter:

npx tabminal --openai-key "YOUR_API_KEY" --accept-terms

Per il deployment persistente, c'è un'immagine Docker già pronta:

docker run --rm -it -p 9846:9846 \
  leask/tabminal \
  --accept-terms

All'avvio senza password, il server genererà un token temporaneo e lo stamperà nella console. Tutte le impostazioni vengono salvate localmente nella directory ~/.tabminal/.

A chi sarà utile questo progetto

Tabminal colma il divario tra il classico SSH tramite terminale e gli IDE cloud pesanti. Se amministri frequentemente un server di casa, lavori da più dispositivi diversi o vuoi testare agenti AI in un ambiente isolato direttamente attraverso il web, il progetto vale sicuramente la pena di essere eseguito localmente. Il repository ha una licenza aperta (MIT), quindi nulla ti impedisce di personalizzarlo per le tue esigenze.