QuickTerminal - Guia

Primers passos

1. Inicia l'aplicació — arribes a la pantalla d'inici amb les sessions desades i un botó per iniciar una nova connexió.
2. Inicia un shell local — toca Local Shell per obrir una sessió de terminal a la teva màquina immediatament.
3. Crea una sessió remota — toca New Session, tria un protocol (SSH, Telnet, Mosh, Serial, AWS SSM o GCP IAP) i introdueix les dades de la connexió.
4. Desa la sessió — dona-li un nom i assigna-la a un grup. Reconnecta-hi amb un sol toc en qualsevol moment.
5. Explora la paleta de comandes — prem Ctrl + Shift + P per accedir a totes les accions des d'una llista cercable.

Vista general de la interfície

Barra lateral

La barra lateral plegable organitza el teu espai de treball:

• Sessions — totes les sessions desades agrupades per projecte o entorn
• SFTP — obre el navegador gràfic de fitxers per a la connexió activa
• Snippets — la teva biblioteca de comandes desades
• AI Agent — obre el panell de l'assistent AI
• Settings / Help — al peu de la barra lateral

Àrea del terminal

L'espai de treball central mostra:

• El terminal actiu amb entrada i sortida completes
• Una barra de pestanyes per canviar entre diverses sessions obertes
• La barra d'estat al peu que mostra l'estat de la connexió, el protocol i el temporitzador de la sessió
• Una vista de panell dividit opcional per executar diversos terminals un al costat de l'altre

Command Palette

Prem Ctrl + Shift + P per obrir la paleta de comandes. Escriu per filtrar accions i prem Enter per executar. Totes les funcions de QuickTerminal són accessibles a través de la paleta.

Local Shell

QuickTerminal inclou un shell local totalment integrat per executar comandes a la teva màquina.

• Detecció del shell — detecta i utilitza automàticament el teu shell predeterminat (bash, zsh, fish, PowerShell)
• Seguiment del directori de treball — la barra d'estat mostra sempre el directori actual
• Historial de comandes — historial persistent entre sessions, cercable amb Ctrl + R
• Variables d'entorn — hereta el teu perfil de shell i entorn automàticament

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

Connexions SSH

SSH és el protocol principal per a l'accés remot segur. QuickTerminal admet totes les funcions modernes de SSH.

Autenticació

• Contrasenya — introdueix credencials en el moment de la connexió o desa-les de manera segura a la sessió
• Basada en clau — utilitza claus RSA, Ed25519 o ECDSA. Importa-les des d'un fitxer o genera parells de claus nous
• Reenviament d'agent — reenvia el teu agent SSH local al host remot per a accés multi-salt sense problemes
• Interactiva per teclat — admet autenticació de dos factors i sol·licituds de repte-resposta

Reenviament de ports

• Reenviament local — fes un túnel d'un port remot cap a la teva màquina local
• Reenviament remot — exposa un servei local al host remot
• Reenviament dinàmic — crea un proxy SOCKS a través del túnel SSH

Configuració de la sessió

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

Altres protocols

Telnet

Configura el host i el port. Les connexions Telnet no són xifrades; utilitza'l només en xarxes de confiança o per a equipament que ho requereixi.

Mosh

Requereix el servidor Mosh instal·lat al host remot. QuickTerminal gestiona automàticament l'intercanvi inicial SSH i la configuració de la sessió UDP. Ideal per a condicions de xarxa mòbils o poc fiables.

Serial

Selecciona el port sèrie, la velocitat en baud (9600, 19200, 38400, 57600, 115200, etc.), els bits de dades, els bits de parada, la paritat i el control de flux. El terminal mostra dades sèrie en brut i admet l'enviament de senyals de ruptura.

AWS SSM

Autentica't amb les teves credencials d'AWS o un rol IAM. Selecciona la instància objectiu per ID o nom. QuickTerminal invoca el connector de sessió SSM per establir la connexió.

GCP IAP

Autentica't amb el teu compte de Google Cloud. Selecciona el projecte, la zona i la instància. QuickTerminal fa el túnel a través d'IAP utilitzant els teus permisos IAM.

Navegador SFTP

El navegador SFTP integrat proporciona un gestor de fitxers gràfic per a qualsevol host connectat per SSH.

• Navega pels directoris — desplaça't pel sistema de fitxers remot amb una vista d'arbre i de llista familiar
• Puja fitxers — arrossega i deixa anar fitxers des de la teva màquina local o utilitza el botó de pujada
• Baixa fitxers — selecciona fitxers i descarrega'ls a un directori local
• Edita remotament — obre fitxers de text en un editor integrat i desa'ls directament al servidor
• Permisos — visualitza i modifica permisos de fitxer, propietat i marques de temps
• Cerca — troba fitxers pel nom dins l'arbre de directoris actual

AI Agents

Els agents AI de QuickTerminal t'ajuden amb la composició de comandes, l'anàlisi de sortides i l'automatització de tasques.

Què poden fer els agents AI

• Generació de comandes — descriu el que vols en llenguatge natural i l'agent suggereix la comanda adequada
• Explicació de sortides — enganxa o canalitza la sortida del terminal a l'agent per obtenir una explicació llegible
• Diagnòstic d'errors — comparteix missatges d'error i obté solucions suggerides amb explicacions
• Automatització multi-pas — descriu un flux de treball i l'agent genera una seqüència de comandes
• Generació d'scripts — demana a l'agent que creï scripts de shell per a tasques repetitives

Utilitzar el panell de l'agent

1. Obre el panell AI Agent des de la barra lateral o prem Ctrl + Shift + A.
2. Escriu la teva sol·licitud en llenguatge natural.
3. Revisa la comanda o explicació suggerida.
4. Fes clic a Insert per enganxar la comanda al terminal, o Copy al porta-retalls.

Snippets

Els snippets et permeten desar, organitzar i inserir ràpidament comandes utilitzades sovint.

Crear un snippet

1. Obre el panell Snippets des de la barra lateral.
2. Toca New Snippet.
3. Introdueix la comanda, un nom i una descripció opcional.
4. Utilitza la sintaxi ${variable_name} per a plantilles parametritzades.
5. Desa a la teva biblioteca de snippets.

Variables de plantilla

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

Quan inserteixes un snippet parametritzat, QuickTerminal et demana que omplis cada variable abans d'inserir la comanda final.

Organitzar snippets

• Assigna etiquetes per agrupar snippets relacionats (per exemple, deployment, monitoring, database)
• Cerca snippets per nom, contingut o etiqueta
• Fixa els snippets més utilitzats per a accés ràpid a la part superior de la llista

Command Palette

La paleta de comandes és un llançador universal d'accions accessible des de qualsevol lloc de QuickTerminal.

• Prem Ctrl + Shift + P per obrir-la
• Escriu per filtrar accions — la concordança aproximada troba el que necessites ràpidament
• Les accions inclouen: crear sessions, obrir SFTP, canviar la configuració, executar snippets i més
• Les accions utilitzades recentment apareixen a la part superior per a un accés repetit ràpid

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

Execution Policies

Les polítiques d'execució et permeten definir regles de seguretat que protegeixen contra comandes accidentals o destructives.

Tipus de polítiques

Configurar polítiques

1. Ves a Settings > Execution Policies.
2. Toca New Policy.
3. Defineix el patró — un prefix de comanda, una regex o una paraula clau per fer la concordança.
4. Tria l'acció (block, confirm, sandbox o log).
5. Estableix l'àmbit — aplica-ho a totes les sessions, a grups específics o a sessions individuals.

Configuració

Aparença

• Theme — modes Light i Dark amb detecció de preferència del sistema
• Font family — tria la teva tipografia monoespaiada preferida per al terminal
• Font size — mida del text del terminal ajustable
• Color scheme — selecciona paletes de colors de terminal integrades o importa esquemes personalitzats

Terminal

• Scrollback buffer — configura quantes línies d'historial mantenir en memòria
• Cursor style — block, underline o bar
• Bell behavior — flaix visual, so del sistema o silenciós
• Copy on select — copia automàticament el text seleccionat al porta-retalls

Connexions

• Default SSH port — estableix un port predeterminat personalitzat per a noves sessions SSH
• Keep-alive interval — envia paquets periòdics per evitar temps d'espera de connexió
• Reconnect on disconnect — intenta restaurar automàticament les connexions caigudes

Execution Policies

• Gestiona regles de block, confirm, sandbox i log
• Activa o desactiva polítiques per grup de sessions

Dreceres de teclat

Consells & trucs

Resolució de problemes

Privadesa

• QuickTerminal no requereix un compte ni iniciar sessió.
• No es recopilen dades d'ús, analítiques ni telemetria.
• Totes les credencials es xifren amb els keystores natius de la plataforma.
• Els agents AI s'executen totalment al dispositiu — no s'envien dades a servidors externs.
• L'historial de sessions i els snippets es desen localment al teu dispositiu.
• Les transferències SFTP són directes entre el teu dispositiu i el host remot.
• L'aplicació funciona totalment fora de línia per al shell local i les connexions sèrie.