Tmux

7/6/2024

6/27/2025

5/22/2025, 9:19:56 AM

Tmux

Terminal Multiplexer. 여러개의 창을 하나의 터미널에서 관리할 수 있게 해준다.

Preview:

~/workspace/cat-logic main*                                                                          19:13:40
❯ ls
README.md docs      sites

~/workspace/cat-logic main*                                                                          19:13:41
❯






 ❐ cat  ↑ 11d 1h 22m  1 editor  2 cli  3 serv>  ↑ ◼◼◼◼◼◼◼◼◼◼ 100% | 19:13 | 28 Aug  park       ip-192-168-0-9

하단의 1 editor, 2 cli, 3 serv는 각각 창(Window)을 나타낸다.

새로운 프로젝트가 아닌 이상 tmux 명령어를 잘 사용하지 않는다. 기존 프로젝트는 tmuxinator로 파일로 관리하여 window 설정을 자동화하는 편이다.

특징

하나의 화면에서 여러개의 터미널을 제어할 수 있다. 터미널 앱을 종료하더라도 백그라운드로 실행된다. 언제든지 tmux 명령어로 tmux session에 연결할 수 있다. 이것은 사실상 tmux 세션 내에서 실행되는 모든 명령어가 백그라운드로 실행되는 것을 의미하기 때문에 오래 걸리는 프로세스를 실행하고, 앱이 종료되어도 프로세스는 유지되니 마음이 좀 놓인다.

tmux: 새 세션을 생성하거나 생성된 세션에 attach 한다.
tmux new -s [NAME]: 새 세션을 생성한다.

기본적으로 C-b키가 tmux shortcut의 시동키다. 나는 controll과 b 사이가 멀어서 C-a로 사용한다:

# ~/.tmux.conf.local
set -g prefix C-a

Tmuxinator

tmux 설정을 파일로 관리하는 도구.

https://github.com/tmuxinator/tmuxinator

설정 파일을 ~/.config/tmuxinator/에 저장하여 전역으로 사용하거나 프로젝트별로 ./.tmuxinator.yml에 저장하여 지역적으로 사용할 수 있다.

tmuxinator 명령어를 제공한다. 명렁어가 길어서 tmuxn alias 만들어서 사용하는 중.

지역적으로 사용할 경우

name: my-project

windows:
  - editor: vi
  - cli:
  - server: npm run develop

.tmuxinator.yml로 저장하고 다음 명령어로 실행한다.

$ tmuxinator  # or tmuxinator start

start 시 설정 이름을 생략하면 .tmuxinator.yml을 찾는다.

전역적으로 사용할 경우

name: my-project
root: ~/workspace/my-project

windows:
  - editor: vi
  - cli:
  - server: npm run develop

$ tmuxinator my-project  # or tmuxinator start my-project

start 시 설정 이름을 지정하면 ~/.config/tmuxinator/에서 name을 찾는다. 일치하는 이름이 없으면 .tmuxinator.yml을 찾는다.

내 사용 방법

주로, 각 프로젝트마다 .tmuxinator.yml 파일을 생성하는 지역적으로 사용한다.

.git/info/exclude에 .tmuxinator.yml을 추가하여 코드베이스에는 포함하지 않을 수 있다.

다음은 에디터와 터미널 용 창을 생성하는 템플릿이다.

name: my-project

windows:
  - editor: vi
  - cli:
      layout: even-horizontal
      panes:
        -
        - npm run test-watch

두 번째 창은 빈 pane과 테스트 watch 모드나 서버와 같이 foreground 상주하는 명령어를 실행해 두는 창을 분할해 둔다.

zoxide를 사용하므로, 터미널을 열고 z my 입력 후 tmuxn만 입력하면 개발 환경이 준비가 끝난다.

플러그인

Tmux 플러그인과 플러그인을 관리하는 매니저가 있다.

TPM은 Tmux Plugin Manager다. 사용하기 위해서 프로젝트를 Clone 받고, .tmux.conf에 설정을 추가해야 하는 과정이 번거롭다.

Tmux Resurrect는 세션을 저장하고 복원하는 플러그인을 사용했었는데, 특별히 사용할 일이 없어서 제거했다.

Oh My Zsh의 Tmux 플러그인

Oh My Zsh의 Tmux 플러그인을 사용하면 편리 기능을 제공한다. 기존 tmux 명령어를 wrapping 하는데, tmux만 입력하면 세션이 없으면 생성하고, 있으면 attach 한다. 그 외에도 몇 가지 alias와 자동 갱신 기능을 제공한다는데 개인적으로는 필요하지 않다.

플러그인 설정은 ~/.zshrc에 추가한다.

plugins=(
  tmux
)

zsh 플러그인에서는 이 기능의 구현이 조금 복잡한데, 플러그인 없이 약식으로 구현할 수 있다.

if command -v tmux &> /dev/null; then
  function _tmux_run() {
    if [[ -n "$@" ]]; then
      command tmux "$@"
    else
      tmux attach
    fi
  }
  compdef _tmux _tmux_run
  alias tmux=_tmux_run
fi

새로운 세션을 생성하는 부분은 생략했지만, 옵션이 있으면 tmux $@를 실행하고, 옵션이 없으면 tmux attach를 실행한다. compdef는 tmux 명령어의 자동 완성을 제공한다.

Tmux