Guide

Плагины

Установка и настройка плагина tmux и плагина shell для Mac

Плагины

MTerm можно расширить, установив плагины на удалённые серверы. Плагины добавляют функции, такие как уведомления о завершении команд, синхронизация буфера обмена и сохранение сессий. Доступны два официальных плагина.


mterm-tmux (плагин для tmux)

Интегрирует tmux с MTerm для синхронизации буфера обмена, обмена контекстом, уведомлений и управления сессиями.

Возможности

ФункцияОписание
Синхронизация буфера обменаСинхронизирует буферы копирования tmux с историей буфера обмена MTerm
Обмен контекстомОтправляет текущий каталог, ветку Git и другую контекстную информацию в MTerm
Уведомления о командахПолучай push-уведомления, когда длительные команды завершаются
Управление сессиямиПросматривай и переключайся между сессиями и окнами tmux

Установка (TPM)

Если ты используешь tmux Plugin Manager (TPM), добавь следующее в ~/.tmux.conf:

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

# Press prefix + I to install

Если у тебя ещё нет TPM, сначала настрой TPM.

Настройка shell-хука

Для включения полной функциональности (особенно обнаружения завершения команд) добавь shell-хук в файл инициализации оболочки:

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

Это позволяет MTerm обнаруживать, когда команды начинаются и заканчиваются, что обеспечивает работу системы уведомлений.

Настройки уведомлений

После установки плагина настрой поведение уведомлений в настройках MTerm (Настройки → Плагины):

НастройкаОписание
Режим уведомленийON (получать уведомления) / OFF (отключить уведомления)
Порог (секунды)Уведомлять только о командах, которые выполняются дольше указанного значения (по умолчанию: 5 секунд, диапазон: 1–120)

Например, порог в 10 секунд означает, что быстрые команды вроде ls или cd не будут вызывать уведомления, а сборки, тесты и длительные скрипты уведомят тебя по завершении.

GitHub

mtermapp/mterm-tmux


mterm-shell (плагин для Mac)

Shell-плагин, который устанавливается прямо на Mac (или Linux-сервер) без необходимости tmux. Предоставляет уведомления о командах, обмен контекстом и опциональное сохранение сессий.

Возможности

ФункцияОписание
Сохранение сессийПоддерживает shell-сессии активными после отключения SSH с помощью abduco
Обмен контекстомОтправляет текущий каталог, ветку Git и другую контекстную информацию в MTerm
Уведомления о командахПолучай push-уведомления, когда длительные команды завершаются

Установка

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

Настройка shell-хука

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

Сохранение сессий (опционально)

Установи abduco, чтобы поддерживать shell-сессии активными даже при обрыве SSH-соединения. При переподключении ты можешь вернуться к той же сессии и продолжить ровно с того места, где остановился.

# Install abduco (macOS)
brew install abduco

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

mterm-session — это обёртка вокруг abduco, которая создаёт именованный постоянный shell. Если SSH-соединение прерывается, shell продолжает работать. При следующем подключении повторно подключись к той же сессии.

Настройки уведомлений

Аналогично mterm-tmux — настрой режим уведомлений и порог в Настройки → Плагины.

GitHub

mtermapp/mterm-shell


Какой плагин использовать?

СитуацияРекомендация
Ты регулярно используешь tmuxmterm-tmux
Ты не используешь tmux / подключаешься напрямую к Macmterm-shell
Нужны оба (tmux + прямые подключения)Установи оба — они не конфликтуют

Ни один плагин не является обязательным. Все основные функции MTerm работают без какой-либо установки на стороне сервера. Плагины — это опциональные улучшения, добавляющие удобные функции.