Guide

Primeros pasos

Qué hace diferente a MTerm y cómo empezar — desde agregar hosts hasta los conceptos básicos del terminal

Primeros pasos con MTerm

MTerm es un cliente SSH construido desde cero para iPad y iPhone, diseñado específicamente para desarrolladores que trabajan con herramientas de terminal IA como Claude Code, Cursor y Aider. Mientras otras apps SSH tratan el móvil como algo secundario, MTerm convierte tu tablet en una máquina de desarrollo genuinamente capaz.


¿Por qué MTerm?

Hay muchos clientes SSH en el App Store. Esto es lo que distingue a MTerm:

División de paneles nativa

Divide tu pantalla en hasta cuatro terminales sin depender de tmux. Cada panel ejecuta su propia sesión independiente, y puedes combinar paneles libremente — terminal, editor de archivos, navegador de archivos o panel de prompts en cualquier combinación. Arrastra los bordes para redimensionar. Simplemente funciona.

Renderizado preciso de caracteres CJK

Los caracteres japoneses, chinos y coreanos se renderizan con su ancho correcto de 2 celdas. Esto parece algo menor hasta que has usado un cliente SSH que lo hace mal — cursores desalineados, texto superpuesto y salida ilegible por todas partes. MTerm lo hace bien porque el motor de renderizado fue reescrito específicamente para esto.

Integración del modo ratón de tmux

MTerm detecta automáticamente cuando tmux tiene el modo ratón habilitado y reenvía directamente tus gestos táctiles — toca para cambiar de panel, desplázate para navegar por el historial. No necesitas configurar nada. Simplemente detecta set -g mouse on y hace lo correcto.

Soporte Mosh

¿Trabajas desde un café con Wi-Fi inestable? ¿En un tren cambiando entre torres celulares? Mosh mantiene tu sesión activa a través de cambios de red. MTerm implementa el protocolo Mosh nativamente, así que tu conexión sobrevive a los cambios de Wi-Fi a datos móviles sin perder una sola tecla.

Explora sistemas de archivos remotos a través de SFTP, previsualiza imágenes y edita código con resaltado de sintaxis — todo sin salir de la app. El editor soporta 11 lenguajes con el esquema de colores VSCode Dark+.

Modo IDE

Combina terminal, navegador de archivos y editor en una sola pantalla. Edita tu código en un panel, ejecútalo en otro, navega archivos en un tercero. Esto es particularmente potente para flujos de trabajo con Claude Code donde necesitas revisar el código generado mientras la IA sigue trabajando.

Paleta de comandos

Presiona Cmd+Shift+P para acceder instantáneamente a cualquier acción — dividir paneles, abrir configuración, cambiar temas, alternar modo focus, y más. Si estás acostumbrado a VS Code, te sentirás como en casa.

Notificaciones Webhook

Configura notificaciones push que se disparan cuando Claude Code termina una tarea, cuando un pipeline CI/CD se completa, o cuando tu servidor envía una alerta. Puedes salir de la app completamente y ser notificado cuando algo necesite tu atención.

Sincronización iCloud

Tus configuraciones de hosts, ajustes de conexión y preferencias se sincronizan automáticamente en todos tus dispositivos. Configura un host en tu iPad y estará listo en tu iPhone.


Agregar un host SSH

Paso 1: Crear un host

Toca el botón Agregar Host en la pantalla de inicio. Completa los detalles de conexión:

CampoDescripción
HostnameDirección IP o nombre de dominio del servidor (ej. 192.168.1.100 o dev.example.com)
PortNúmero de puerto SSH. Casi siempre 22 a menos que tu servidor esté configurado de otra manera
UsernameTu nombre de usuario en el servidor remoto
Auth MethodContraseña o clave SSH (se recomienda encarecidamente la autenticación por clave)

Paso 2: Configurar la autenticación por clave SSH

MTerm soporta los siguientes formatos de clave:

  • Ed25519 — Recomendado. Moderno, rápido y seguro. Si generas una nueva clave, usa este.
  • RSA PKCS#1 — Formato tradicional que comienza con -----BEGIN RSA PRIVATE KEY-----. Ampliamente compatible.
  • RSA OpenSSH — Formato OpenSSH más nuevo que comienza con -----BEGIN OPENSSH PRIVATE KEY-----. También totalmente soportado.

Todas las claves privadas se almacenan de forma segura en el iOS Keychain, protegidas por la seguridad de hardware del dispositivo. Las claves nunca abandonan el dispositivo y no se incluyen en las copias de seguridad de iCloud.

Para importar una clave, puedes pegarla directamente, importarla desde un archivo o usar el portapapeles.

Paso 3: Opciones de conexión avanzadas

MTerm soporta varias configuraciones avanzadas para instalaciones más complejas:

  • Jump Hosts (servidores Bastion): Conéctate a través de servidores intermedios cuando tu máquina destino no es directamente accesible. MTerm maneja la cadena SSH multi-salto por ti, incluyendo la autenticación RSA-SHA256 a través de jump hosts.
  • Port Forwarding: Configura redirecciones de puertos locales (accede a servicios remotos como si fueran locales) o redirecciones de puertos remotos (expón servicios locales a la red remota). Las redirecciones se guardan por host y se reconectan automáticamente.
  • Iconos personalizados: Asigna un icono único a cada host para distinguir visualmente de un vistazo tu servidor de producción, entorno de staging y máquina de desarrollo.
  • Sincronización iCloud: Las configuraciones de hosts se comparten automáticamente en todos tus dispositivos. Agrega un host en tu iPad, conéctate desde tu iPhone.

Conceptos básicos del terminal

Toca cualquier host para establecer una conexión SSH. Una vez conectado, la vista del terminal se abre y estás listo para trabajar.

Desplazamiento

El desplazamiento táctil y por trackpad están totalmente soportados. Desliza con un dedo en la pantalla, o usa dos dedos en un trackpad Magic Keyboard. El búfer de desplazamiento almacena hasta 5,000 líneas de historial (el valor por defecto es 1,000, configurable en ajustes).

Copiar texto

Mantén pulsado en cualquier lugar del terminal para abrir el menú radial — un menú contextual circular que te da acceso rápido a copiar, pegar, seleccionar todo y otras acciones. Selecciona el texto deseado y luego toca la acción de copiar.

Pegar texto

Usa el botón de pegar en la barra de teclas virtuales, el menú radial o el atajo de teclado estándar Cmd+V con un teclado físico.

Teclado

MTerm incluye una barra de teclas virtuales personalizable sobre el teclado en pantalla con teclas modificadoras (Ctrl, Alt, Escape) y teclas de flecha. Cuando conectas un teclado físico como el Magic Keyboard, más de 25 atajos de teclado están disponibles. Consulta la guía Teclado y entrada para la lista completa.


Próximos pasos

Ahora que estás conectado, explora estas guías para sacar el máximo provecho de MTerm: