Guide

플러그인

tmux 플러그인과 Mac Shell 플러그인 설치 및 설정

플러그인

MTerm은 원격 서버에 플러그인을 설치해서 확장할 수 있어요. 플러그인은 명령어 완료 알림, 클립보드 동기화, 세션 지속성 같은 기능을 추가해요. 두 가지 공식 플러그인이 제공돼요.


mterm-tmux (tmux 플러그인)

클립보드 동기화, Context Sharing, 알림, 세션 관리를 위해 tmux를 MTerm과 통합해요.

기능

기능설명
클립보드 동기화tmux 복사 버퍼를 MTerm의 클립보드 히스토리와 동기화
Context Sharing현재 디렉토리, Git 브랜치 및 기타 컨텍스트를 MTerm에 전송
명령어 알림장시간 실행되는 명령어가 완료되면 푸시 알림 수신
세션 관리tmux 세션과 Window 목록 보기 및 전환

설치 (TPM)

tmux Plugin Manager (TPM)를 사용한다면 ~/.tmux.conf에 다음을 추가하세요:

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

# Press prefix + I to install

TPM이 아직 없다면 먼저 TPM을 설정하세요.

Shell Hook 설정

전체 기능(특히 명령어 완료 감지)을 활성화하려면 Shell 초기화 파일에 Shell Hook을 추가하세요:

# ~/.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초로 설정하면 lscd 같은 빠른 명령어는 알림을 트리거하지 않지만, 빌드, 테스트, 장시간 실행되는 스크립트가 완료되면 알림을 받아요.

GitHub

mtermapp/mterm-tmux


mterm-shell (Mac 플러그인)

tmux 없이 Mac(또는 Linux 서버)에 직접 설치하는 Shell 플러그인이에요. 명령어 알림, Context Sharing, 선택적 세션 지속성을 제공해요.

기능

기능설명
세션 지속성abduco를 사용해서 SSH 연결이 끊어진 후에도 Shell 세션을 유지
Context Sharing현재 디렉토리, Git 브랜치 및 기타 컨텍스트를 MTerm에 전송
명령어 알림장시간 실행되는 명령어가 완료되면 푸시 알림 수신

설치

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

Shell Hook 설정

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

세션 지속성 (선택 사항)

abduco를 설치하면 SSH 연결이 끊어져도 Shell 세션을 유지할 수 있어요. 재연결하면 같은 세션에 다시 연결해서 떠났던 곳에서 정확히 이어서 작업할 수 있어요.

# Install abduco (macOS)
brew install abduco

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

mterm-sessionabduco의 래퍼로 명명된 영구 Shell을 만들어요. SSH 연결이 끊어져도 Shell은 계속 실행돼요. 다음 연결 시 같은 세션에 다시 연결하세요.

알림 설정

mterm-tmux와 동일해요 — 설정 → 플러그인에서 알림 모드와 임계값을 구성하세요.

GitHub

mtermapp/mterm-shell


어떤 플러그인을 사용해야 할까요?

상황추천
tmux를 정기적으로 사용하는 경우mterm-tmux
tmux를 사용하지 않는 경우 / Mac에 직접 연결하는 경우mterm-shell
둘 다 원하는 경우 (tmux + 직접 연결)둘 다 설치하세요 — 충돌하지 않아요

어떤 플러그인도 필수가 아니에요. MTerm의 모든 핵심 기능은 서버 측 설치 없이 작동해요. 플러그인은 편의 기능을 추가하는 선택적 확장이에요.