플러그인
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초로 설정하면 ls나 cd 같은 빠른 명령어는 알림을 트리거하지 않지만, 빌드, 테스트, 장시간 실행되는 스크립트가 완료되면 알림을 받아요.
GitHub
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-session은 abduco의 래퍼로 명명된 영구 Shell을 만들어요. SSH 연결이 끊어져도 Shell은 계속 실행돼요. 다음 연결 시 같은 세션에 다시 연결하세요.
알림 설정
mterm-tmux와 동일해요 — 설정 → 플러그인에서 알림 모드와 임계값을 구성하세요.
GitHub
어떤 플러그인을 사용해야 할까요?
| 상황 | 추천 |
|---|---|
| tmux를 정기적으로 사용하는 경우 | mterm-tmux |
| tmux를 사용하지 않는 경우 / Mac에 직접 연결하는 경우 | mterm-shell |
| 둘 다 원하는 경우 (tmux + 직접 연결) | 둘 다 설치하세요 — 충돌하지 않아요 |
어떤 플러그인도 필수가 아니에요. MTerm의 모든 핵심 기능은 서버 측 설치 없이 작동해요. 플러그인은 편의 기능을 추가하는 선택적 확장이에요.