QuickTerminal - Guía

Primeros pasos

1. Inicia la aplicación — llegas a la pantalla principal con tus sesiones guardadas y un botón para iniciar una nueva conexión.
2. Inicia un shell local — toca Local Shell para abrir inmediatamente una sesión de terminal en tu máquina.
3. Crea una sesión remota — toca New Session, elige un protocolo (SSH, Telnet, Mosh, Serial, AWS SSM o GCP IAP) e introduce los datos de conexión.
4. Guarda la sesión — ponle un nombre y asígnala a un grupo. Vuelve a conectar con un solo toque en cualquier momento.
5. Explora la paleta de comandos — pulsa Ctrl + Shift + P para acceder a todas las acciones desde una lista buscable.

Visión general de la interfaz

Barra lateral

La barra lateral plegable organiza tu espacio de trabajo:

• Sessions — todas las sesiones guardadas agrupadas por proyecto o entorno
• SFTP — abre el navegador gráfico de archivos para la conexión activa
• Snippets — tu biblioteca de comandos guardados
• AI Agent — abre el panel del asistente de IA
• Settings / Help — en la parte inferior de la barra lateral

Área del terminal

El espacio de trabajo central muestra:

• El terminal activo con entrada y salida completas
• Una barra de pestañas para cambiar entre varias sesiones abiertas
• La barra de estado en la parte inferior que muestra el estado de la conexión, el protocolo y el temporizador de la sesión
• Una vista de panel dividido opcional para ejecutar varios terminales en paralelo

Command Palette

Pulsa Ctrl + Shift + P para abrir la paleta de comandos. Escribe para filtrar acciones y pulsa Enter para ejecutar. Todas las funciones de QuickTerminal son accesibles a través de la paleta.

Local Shell

QuickTerminal incluye un shell local totalmente integrado para ejecutar comandos en tu propia máquina.

• Detección del shell — detecta y utiliza automáticamente tu shell predeterminado (bash, zsh, fish, PowerShell)
• Seguimiento del directorio de trabajo — la barra de estado siempre muestra tu directorio actual
• Historial de comandos — historial persistente entre sesiones, buscable con Ctrl + R
• Variables de entorno — hereda automáticamente tu perfil de shell y entorno

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

Conexiones SSH

SSH es el protocolo principal para acceso remoto seguro. QuickTerminal admite todas las funciones modernas de SSH.

Autenticación

• Contraseña — introduce las credenciales al conectar o guárdalas de forma segura en la sesión
• Basada en clave — utiliza claves RSA, Ed25519 o ECDSA. Importa desde archivo o genera nuevos pares de claves
• Reenvío de agente — reenvía tu agente SSH local al host remoto para acceso sin problemas multisalto
• Interactiva por teclado — admite autenticación de dos factores y solicitudes de desafío-respuesta

Reenvío de puertos

• Reenvío local — haz un túnel de un puerto remoto a tu máquina local
• Reenvío remoto — expón un servicio local al host remoto
• Reenvío dinámico — crea un proxy SOCKS a través del túnel SSH

Configuración de sesión

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

Otros protocolos

Telnet

Configura el host y el puerto. Las conexiones Telnet no están cifradas; úsalas solo en redes de confianza o para equipos que lo requieran.

Mosh

Requiere el servidor Mosh instalado en el host remoto. QuickTerminal gestiona automáticamente el handshake SSH inicial y la configuración de la sesión UDP. Ideal para condiciones de red móviles o poco fiables.

Serial

Selecciona el puerto serie, la velocidad en baudios (9600, 19200, 38400, 57600, 115200, etc.), los bits de datos, los bits de parada, la paridad y el control de flujo. El terminal muestra datos serie en bruto y admite el envío de señales de ruptura.

AWS SSM

Autentícate con tus credenciales de AWS o un rol IAM. Selecciona la instancia de destino por ID o nombre. QuickTerminal invoca el complemento de sesión SSM para establecer la conexión.

GCP IAP

Autentícate con tu cuenta de Google Cloud. Selecciona el proyecto, la zona y la instancia. QuickTerminal hace el túnel a través de IAP utilizando tus permisos IAM.

Navegador SFTP

El navegador SFTP incorporado proporciona un gestor gráfico de archivos para cualquier host conectado por SSH.

• Navega por los directorios — desplázate por el sistema de archivos remoto con una vista de árbol y lista familiar
• Sube archivos — arrastra y suelta archivos desde tu máquina local o usa el botón de subida
• Descarga archivos — selecciona archivos y descárgalos a un directorio local
• Edita remotamente — abre archivos de texto en un editor integrado y guárdalos directamente en el servidor
• Permisos — visualiza y modifica permisos de archivos, propiedad y marcas de tiempo
• Búsqueda — encuentra archivos por nombre dentro del árbol de directorios actual

AI Agents

Los agentes de IA de QuickTerminal te ayudan con la composición de comandos, el análisis de salidas y la automatización de tareas.

Qué pueden hacer los agentes de IA

• Generación de comandos — describe lo que quieres en lenguaje natural y el agente sugiere el comando correcto
• Explicación de salidas — pega o redirige la salida del terminal al agente para obtener un análisis legible
• Diagnóstico de errores — comparte mensajes de error y obtén soluciones sugeridas con explicaciones
• Automatización multietapa — describe un flujo de trabajo y el agente genera una secuencia de comandos
• Generación de scripts — pide al agente que cree scripts de shell para tareas repetitivas

Uso del panel del agente

1. Abre el panel AI Agent desde la barra lateral o pulsa Ctrl + Shift + A.
2. Escribe tu solicitud en lenguaje natural.
3. Revisa el comando o explicación sugerida.
4. Haz clic en Insert para pegar el comando en tu terminal, o Copy al portapapeles.

Snippets

Los snippets te permiten guardar, organizar e insertar rápidamente comandos utilizados con frecuencia.

Crear un snippet

1. Abre el panel Snippets desde la barra lateral.
2. Toca New Snippet.
3. Introduce el comando, un nombre y una descripción opcional.
4. Utiliza la sintaxis ${variable_name} para plantillas parametrizadas.
5. Guarda en tu biblioteca de snippets.

Variables de plantilla

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

Cuando insertas un snippet parametrizado, QuickTerminal te pide que rellenes cada variable antes de insertar el comando final.

Organizar snippets

• Asigna etiquetas para agrupar snippets relacionados (por ejemplo, deployment, monitoring, database)
• Busca snippets por nombre, contenido o etiqueta
• Ancla tus snippets más usados para acceso rápido en la parte superior de la lista

Command Palette

La paleta de comandos es un lanzador universal de acciones accesible desde cualquier parte de QuickTerminal.

• Pulsa Ctrl + Shift + P para abrirla
• Escribe para filtrar acciones — la coincidencia aproximada encuentra lo que necesitas rápidamente
• Las acciones incluyen: crear sesiones, abrir SFTP, cambiar configuraciones, ejecutar snippets y más
• Las acciones usadas recientemente aparecen en la parte superior para acceso rápido repetido

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

Execution Policies

Las políticas de ejecución te permiten definir reglas de seguridad que protegen contra comandos accidentales o destructivos.

Tipos de políticas

Configurar políticas

1. Ve a Settings > Execution Policies.
2. Toca New Policy.
3. Define el patrón — un prefijo de comando, una expresión regular o una palabra clave para coincidir.
4. Elige la acción (block, confirm, sandbox o log).
5. Establece el ámbito — aplicar a todas las sesiones, grupos específicos o sesiones individuales.

Configuración

Apariencia

• Theme — modos Claro y Oscuro con detección de preferencia del sistema
• Font family — elige tu fuente monoespaciada preferida para el terminal
• Font size — tamaño de texto del terminal ajustable
• Color scheme — selecciona paletas de colores de terminal integradas o importa esquemas personalizados

Terminal

• Scrollback buffer — configura cuántas líneas de historial mantener en memoria
• Cursor style — block, underline o bar
• Bell behavior — destello visual, sonido del sistema o silencioso
• Copy on select — copia automáticamente el texto seleccionado al portapapeles

Conexiones

• Default SSH port — establece un puerto predeterminado personalizado para nuevas sesiones SSH
• Keep-alive interval — envía paquetes periódicos para evitar tiempos de espera de conexión
• Reconnect on disconnect — intenta automáticamente restaurar las conexiones caídas

Execution Policies

• Gestiona reglas de block, confirm, sandbox y log
• Activa o desactiva políticas por grupo de sesiones

Atajos de teclado

Consejos & trucos

Solución de problemas

Privacidad

• QuickTerminal no requiere una cuenta ni inicio de sesión.
• No se recopilan datos de uso, analíticas ni telemetría.
• Todas las credenciales se cifran utilizando los keystores nativos de la plataforma.
• Los agentes de IA se ejecutan completamente en el dispositivo — no se envían datos a servidores externos.
• El historial de sesiones y los snippets se almacenan localmente en tu dispositivo.
• Las transferencias SFTP son directas entre tu dispositivo y el host remoto.
• La aplicación funciona completamente sin conexión para el shell local y las conexiones serie.