QuickTerminal - Guida

Per iniziare

1. Avvia l'app — arrivi alla schermata iniziale con le tue sessioni salvate e un pulsante per avviare una nuova connessione.
2. Avvia una shell locale — tocca Local Shell per aprire immediatamente una sessione di terminale sul tuo dispositivo.
3. Crea una sessione remota — tocca New Session, scegli un protocollo (SSH, Telnet, Mosh, Serial, AWS SSM o GCP IAP) e inserisci i dettagli di connessione.
4. Salva la sessione — assegnale un nome e un gruppo. Riconnettiti con un solo tocco in qualsiasi momento.
5. Esplora la Command Palette — premi Ctrl + Shift + P per accedere a ogni azione da un unico elenco ricercabile.

Panoramica dell'interfaccia

Barra laterale

La barra laterale comprimibile organizza il tuo spazio di lavoro:

• Sessioni — tutte le sessioni salvate raggruppate per progetto o ambiente
• SFTP — apri il browser grafico dei file per la connessione attiva
• Snippet — la tua libreria di comandi salvati
• AI Agent — avvia il pannello dell'assistente AI
• Impostazioni / Aiuto — in fondo alla barra laterale

Area Terminale

L'area di lavoro centrale mostra:

• Il terminale attivo con input e output completi
• Una barra delle schede per passare tra più sessioni aperte
• La barra di stato in basso che mostra lo stato della connessione, il protocollo e il timer della sessione
• Una vista a riquadri divisi opzionale per eseguire più terminali affiancati

Command Palette

Premi Ctrl + Shift + P per aprire la Command Palette. Digita per filtrare le azioni, quindi premi Enter per eseguirle. Ogni funzionalità di QuickTerminal è accessibile tramite la palette.

Shell locale

QuickTerminal include una shell locale completamente integrata per eseguire comandi sul tuo dispositivo.

• Rilevamento della shell — rileva e utilizza automaticamente la tua shell predefinita (bash, zsh, fish, PowerShell)
• Tracciamento della directory di lavoro — la barra di stato mostra sempre la tua directory corrente
• Cronologia dei comandi — cronologia persistente tra le sessioni, ricercabile con Ctrl + R
• Variabili d'ambiente — eredita automaticamente il profilo e l'ambiente della tua shell

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

Connessioni SSH

SSH è il protocollo principale per l'accesso remoto sicuro. QuickTerminal supporta tutte le funzionalità SSH moderne.

Autenticazione

• Password — inserisci le credenziali al momento della connessione o salvale in modo sicuro nella sessione
• Basata su chiave — usa chiavi RSA, Ed25519 o ECDSA. Importa da file o genera nuove coppie di chiavi
• Agent forwarding — inoltra il tuo SSH agent locale all'host remoto per un accesso multi-hop senza interruzioni
• Keyboard-interactive — supporta l'autenticazione a due fattori e i prompt challenge-response

Port Forwarding

• Forwarding locale — crea un tunnel da una porta remota verso la tua macchina locale
• Forwarding remoto — esponi un servizio locale all'host remoto
• Forwarding dinamico — crea un proxy SOCKS attraverso il tunnel SSH

Configurazione della sessione

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

Altri protocolli

Telnet

Configura host e porta. Le connessioni Telnet non sono crittografate; usale solo su reti affidabili o per apparecchiature che lo richiedono.

Mosh

Richiede il server Mosh installato sull'host remoto. QuickTerminal gestisce automaticamente l'handshake SSH iniziale e la configurazione della sessione UDP. Ideale per condizioni di rete mobili o inaffidabili.

Serial

Seleziona la porta seriale, il baud rate (9600, 19200, 38400, 57600, 115200, ecc.), i bit di dati, i bit di stop, la parità e il controllo di flusso. Il terminale visualizza i dati seriali raw e supporta l'invio di segnali di break.

AWS SSM

Autenticati con le tue credenziali AWS o con un ruolo IAM. Seleziona l'istanza di destinazione per ID o nome. QuickTerminal richiama il plugin di sessione SSM per stabilire la connessione.

GCP IAP

Autenticati con il tuo account Google Cloud. Seleziona progetto, zona e istanza. QuickTerminal crea il tunnel tramite IAP utilizzando le tue autorizzazioni IAM.

Browser SFTP

Il browser SFTP integrato fornisce un file manager grafico per qualsiasi host connesso tramite SSH.

• Sfoglia directory — naviga il filesystem remoto con una familiare vista ad albero e a elenco
• Carica file — trascina i file dal tuo dispositivo o usa il pulsante di caricamento
• Scarica file — seleziona i file e scaricali in una directory locale
• Modifica da remoto — apri file di testo in un editor integrato e salvali direttamente sul server
• Permessi — visualizza e modifica permessi, proprietà e timestamp dei file
• Ricerca — trova file per nome all'interno dell'albero della directory corrente

Agenti AI

Gli agenti AI di QuickTerminal ti assistono nella composizione di comandi, nell'analisi dell'output e nell'automazione delle attività.

Cosa possono fare gli agenti AI

• Generazione di comandi — descrivi cosa vuoi in linguaggio naturale e l'agente suggerisce il comando giusto
• Spiegazione dell'output — incolla o invia l'output del terminale all'agente per una spiegazione leggibile
• Diagnosi degli errori — condividi i messaggi di errore e ottieni correzioni suggerite con spiegazioni
• Automazione multi-step — descrivi un flusso di lavoro e l'agente genera una sequenza di comandi
• Generazione di script — chiedi all'agente di creare shell script per attività ripetitive

Utilizzo del pannello Agent

1. Apri il pannello AI Agent dalla barra laterale o premi Ctrl + Shift + A.
2. Digita la tua richiesta in linguaggio naturale.
3. Rivedi il comando o la spiegazione suggerita.
4. Clicca Insert per incollare il comando nel tuo terminale, oppure Copy per copiarlo negli appunti.

Snippet

Gli snippet ti permettono di salvare, organizzare e inserire rapidamente i comandi usati frequentemente.

Creazione di uno snippet

1. Apri il pannello Snippets dalla barra laterale.
2. Tocca New Snippet.
3. Inserisci il comando, un nome e una descrizione facoltativa.
4. Usa la sintassi ${variable_name} per template parametrizzati.
5. Salva nella tua libreria di snippet.

Variabili del template

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

Quando inserisci uno snippet parametrizzato, QuickTerminal ti chiede di riempire ogni variabile prima di inserire il comando finale.

Organizzare gli snippet

• Assegna tag per raggruppare snippet correlati (es. deployment, monitoring, database)
• Cerca gli snippet per nome, contenuto o tag
• Fissa gli snippet più usati per un accesso rapido in cima alla lista

Command Palette

La Command Palette è un avviatore universale di azioni accessibile da qualsiasi punto di QuickTerminal.

• Premi Ctrl + Shift + P per aprirla
• Digita per filtrare le azioni — il fuzzy matching trova rapidamente ciò che ti serve
• Le azioni includono: creazione di sessioni, apertura di SFTP, modifica delle impostazioni, esecuzione di snippet e altro
• Le azioni usate di recente appaiono in cima per un accesso rapido

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

Le Execution Policies ti permettono di definire regole di sicurezza che proteggono da comandi accidentali o distruttivi.

Tipi di policy

Configurare le policy

1. Vai in Settings > Execution Policies.
2. Tocca New Policy.
3. Definisci il pattern — un prefisso di comando, una regex o una parola chiave da abbinare.
4. Scegli l'azione (block, confirm, sandbox o log).
5. Imposta l'ambito — applica a tutte le sessioni, a gruppi specifici o a singole sessioni.

Impostazioni

Aspetto

• Tema — modalità Chiara e Scura con rilevamento delle preferenze di sistema
• Famiglia di caratteri — scegli il tuo font monospaziato preferito per il terminale
• Dimensione del carattere — dimensione del testo del terminale regolabile
• Schema colori — seleziona dalle palette di colori integrate o importa schemi personalizzati

Terminale

• Buffer di scrollback — configura quante righe di cronologia mantenere in memoria
• Stile del cursore — blocco, sottolineatura o barra
• Comportamento bell — flash visivo, suono di sistema o silenzioso
• Copia alla selezione — copia automaticamente il testo evidenziato negli appunti

Connessioni

• Porta SSH predefinita — imposta una porta predefinita personalizzata per le nuove sessioni SSH
• Intervallo Keep-alive — invia pacchetti periodici per evitare i timeout di connessione
• Riconnetti alla disconnessione — tenta automaticamente di ripristinare le connessioni cadute

Execution Policies

• Gestisci regole di block, confirm, sandbox e log
• Abilita o disabilita le policy per gruppo di sessioni

Scorciatoie da tastiera

Consigli e trucchi

Risoluzione dei problemi

Privacy

• QuickTerminal non richiede un account o l'accesso.
• Non vengono raccolti dati di utilizzo, analytics o telemetria.
• Tutte le credenziali sono crittografate usando i keystore nativi della piattaforma.
• Gli agenti AI funzionano interamente sul dispositivo — nessun dato viene inviato a server esterni.
• La cronologia delle sessioni e gli snippet sono archiviati localmente sul tuo dispositivo.
• I trasferimenti SFTP sono diretti tra il tuo dispositivo e l'host remoto.
• L'app funziona completamente offline per shell locale e connessioni seriali.