Plugins

MTerm puede extenderse instalando plugins en tus servidores remotos. Los plugins agregan funciones como notificaciones de finalización de comandos, sincronización del portapapeles y persistencia de sesiones. Hay dos plugins oficiales disponibles.

mterm-tmux (plugin de tmux)

Integra tmux con MTerm para sincronización del portapapeles, compartir contexto, notificaciones y gestión de sesiones.

Funciones

Función	Descripción
Sincronización del portapapeles	Sincroniza los búferes de copia de tmux con el historial del portapapeles de MTerm
Compartir contexto	Envía el directorio actual, rama Git y otra información de contexto a MTerm
Notificaciones de comandos	Recibe notificaciones push cuando comandos de larga duración terminan
Gestión de sesiones	Lista y cambia entre sesiones y ventanas de tmux

Instalación (TPM)

Si usas tmux Plugin Manager (TPM), agrega lo siguiente a tu ~/.tmux.conf:

# ~/.tmux.conf
set -g @plugin 'mtermapp/mterm-tmux'

# Press prefix + I to install

Si no tienes TPM aún, configura primero TPM.

Configuración del hook shell

Para habilitar la funcionalidad completa (especialmente la detección de finalización de comandos), agrega el hook shell a tu archivo de inicialización del shell:

# ~/.zshrc or ~/.bashrc
[ -f ~/.tmux/plugins/mterm-tmux/scripts/init.sh ] \
  && source ~/.tmux/plugins/mterm-tmux/scripts/init.sh

Esto permite a MTerm detectar cuándo los comandos inician y terminan, lo que alimenta el sistema de notificaciones.

Configuración de notificaciones

Una vez instalado el plugin, configura el comportamiento de notificaciones en la configuración de MTerm (Configuración → Plugins):

Ajuste	Descripción
Modo de notificación	ON (recibir notificaciones) / OFF (desactivar notificaciones)
Umbral (segundos)	Solo notificar para comandos que tarden más que este valor (por defecto: 5 segundos, rango: 1–120)

Por ejemplo, establecer el umbral en 10 segundos significa que comandos rápidos como ls o cd no activarán notificaciones, pero builds, pruebas y scripts de larga duración te notificarán cuando se completen.

GitHub

mtermapp/mterm-tmux

mterm-shell (plugin para Mac)

Un plugin shell que se instala directamente en tu Mac (o servidor Linux) sin requerir tmux. Proporciona notificaciones de comandos, compartir contexto y persistencia opcional de sesiones.

Funciones

Función	Descripción
Persistencia de sesiones	Mantiene sesiones shell activas después de desconexiones SSH usando `abduco`
Compartir contexto	Envía el directorio actual, rama Git y otra información de contexto a MTerm
Notificaciones de comandos	Recibe notificaciones push cuando comandos de larga duración terminan

Instalación

git clone https://github.com/mtermapp/mterm-shell \
  ~/.mterm/plugin

Configuración del hook shell

# ~/.zshrc or ~/.bashrc
[ -f ~/.mterm/plugin/init.sh ] \
  && source ~/.mterm/plugin/init.sh

Persistencia de sesiones (opcional)

Instala abduco para mantener sesiones shell activas incluso cuando tu conexión SSH se cae. Cuando te reconectes, puedes volver a conectarte a la misma sesión y retomar exactamente donde lo dejaste.

# Install abduco (macOS)
brew install abduco

# Create a persistent session
mterm-session "my-project"

mterm-session es un wrapper alrededor de abduco que crea un shell persistente con nombre. Si tu conexión SSH se cae, el shell sigue ejecutándose. En tu siguiente conexión, reconéctate a la misma sesión.

Configuración de notificaciones

Igual que mterm-tmux — configura el modo de notificación y umbral en Configuración → Plugins.

GitHub

mtermapp/mterm-shell

¿Qué plugin deberías usar?

Situación	Recomendación
Usas tmux regularmente	mterm-tmux
No usas tmux / te conectas directamente al Mac	mterm-shell
Quieres ambos (tmux + conexiones directas)	Instala ambos — no generan conflicto

Ningún plugin es obligatorio. Todas las funciones principales de MTerm funcionan sin ninguna instalación del lado del servidor. Los plugins son mejoras opcionales que agregan funciones de conveniencia.