터미널에서 AI 에이전트, 에디터, 개발 서버, 로그 모니터링을 나란히 배치하고 싶다. 하지만 tmux는 설정이나 키 조작을 익히기까지 조금 힘들다―― 그런 분들에게 추천하고 싶은 것이 Zellij입니다.

Zellij는 초기 상태부터 탭, 페인 (Pane), 마우스 조작, 화면 하단의 키 힌트(Key hint)를 사용할 수 있는 터미널 워크스페이스입니다. 본 기사에서는 일상적인 조작을 바로 찾아볼 수 있는 치트시트(Cheat sheet)로서 정리합니다.

본 기사는

Zellij 0.44.3 / Default keybinding preset 환경에서 확인했습니다. 독자적인 설정이나 Unlock-First preset을 사용하고 있는 경우에는 키가 다릅니다.

macOS (Homebrew)의 경우:

brew install zellij

Rust 환경이 있는 경우:

# 빌드된 바이너리를 도입
cargo binstall zellij
# 또는 소스에서 빌드
...

Linux, macOS, Windows용 빌드된 바이너리도 공식 릴리스(Official release)에서 취득할 수 있습니다. OS별 방법은 공식 Installation을 확인해 주세요.

zellij --version
zellij -s my-project

종료하지 않고 원래의 쉘 (Shell)로 돌아가려면, Ctrl+o를 누르고 뗀 뒤, 이어서 d를 누릅니다. 이것이 디태치 (Detach) 입니다.

Ctrl+p → n은 동시 입력이 아닙니다. Ctrl+p를 뗀 후에 n을 누릅니다.

Zellij는 「모드 (Mode)」를 전환하며 조작합니다. 예를 들어 Ctrl+p로 Pane 모드에 들어가면, 화면 하단이 Pane 조작 목록으로 바뀝니다. 길을 잃었다면 우선 아래의 키 힌트를 보면 괜찮습니다. Esc 또는 Enter로 일반 모드로 돌아올 수 있습니다.

• 상단: 탭. 이미지에서는 dev와 logs 2개의 탭
• 중앙: 일반적인 타일 페인 (Tile pane). 경계를 마우스로 드래그하여 리사이즈 가능
• 전면: 플로팅 페인 (Floating pane). 간단한 확인이나 일시적인 작업에 편리
• 하단: 현재 모드와 이용 가능한 키 힌트

이미지는 글자 깨짐을 피하기 위해 simplified_ui true에 상당하는 호환 표시를 사용하고 있습니다. 일반 표시에서도 조작은 동일합니다.

Alt 계열은 일반 모드에서 직접 실행할 수 있는 단축키입니다.

Locked 모드에서는 Ctrl+g 이외의 키 입력이 Zellij에 빼앗기지 않고, 그대로 페인 내의 앱으로 전달됩니다. Vim이나 쉘의 키 바인딩 (Key binding)과 충돌할 때 편리합니다. 해제도 Ctrl+g 입니다.

Ctrl+p로 Pane 모드에 들어갑니다.

작업 영역을 일시적으로 넓히고 싶을 뿐이라면, 닫기인 x가 아니라 전체 화면인 f

를 사용하면 원래의 분할 상태를 유지할 수 있습니다.

Ctrl+t를 눌러 Tab 모드로 들어갑니다.

입력 동기화 Ctrl+t → s는 여러 호스트에 동일한 명령을 보낼 때 매우 강력합니다. 삭제나 재시작 등의 명령도 모든 페인으로 전송되므로, 실행 후에는 동일한 키로 다시 꺼두는 것이 안전합니다.

Ctrl+n을 눌러 Resize 모드로 들어갑니다.

평소에는 Alt++ / Alt+-를 사용하고, 세밀하게 방향을 지정하고 싶을 때는 Resize 모드를 사용하는 식으로 구분해서 익히면 쉽습니다.

Ctrl+h를 눌러 Move 모드로 들어갑니다.

Ctrl+s를 눌러 Scroll 모드로 들어갑니다. 앱 측이 아니라 Zellij가 유지하는 페인의 스크롤백 (Scrollback)을 조작하는 모드입니다.

s를 눌러 검색어를 입력하고 Enter를 누르면 Search 모드가 됩니다.

마우스로 문자열을 선택하면 기본 설정상 자동으로 복사됩니다. 터미널 에뮬레이터 본연의 선택 기능을 사용하고 싶다면 Shift를 누른 채 드래그하세요.

Ctrl+o를 눌러 Session 모드로 들어갑니다.

주의: 작업을 남겨두고 돌아가고 싶을 때 Ctrl+q는 Detach가 아니라 Zellij 종료입니다. Ctrl+o → d를 사용해야 합니다.

# 세션 목록 (종료되었지만 복구 가능한 세션도 표시)
zellij list-sessions
zellij ls
...

Zellij는 기본 설정으로 세션의 탭, 페인, 각 페인의 명령어를 캐시 (Cache)에 저장합니다. 종료나 크래시 (Crash) 후에도 zellij ls의 EXITED 항목 또는 Session Manager를 통해 복구할 수 있습니다.

복구 시 저장된 명령어는 안전을 위해 자동으로 실행되지 않으며, Enter를 누를 때까지 대기합니다. 자세한 내용은 Session Resurrection에 정리되어 있습니다.

매일 아침 동일하게 에디터, 서버, 테스트를 연다면 KDL 형식의 Layout으로 설정해 두어 한 번에 재현할 수 있습니다.

~/.config/zellij/layouts/dev.kdl:

layout {
// 자신의 프로젝트로 변경
cwd "/path/to/your/project"
...
}

실행합니다:

zellij --layout dev -s my-project

nvim을 사용하지 않는 경우, command="nvim"을 삭제하거나 원하는 명령어로 변경하세요. 기존 화면에서 레이아웃을 기록하고 싶다면 Ctrl+o → l로 Layout Manager를 열 수 있습니다. 레이아웃의 모든 구문은 Creating a Layout에 있습니다.

표준 설정 경로는 ~/.config/zellij/config.kdl입니다. 파일이 없는 경우, 기본 설정을 토대로 생성할 수 있습니다.

mkdir -p ~/.config/zellij
zellij setup --dump-config > ~/.config/zellij/config.kdl
zellij setup --check

이미 설정 파일이 있는 경우, >를 사용하여 덮어쓰지 않도록 주의하세요.

자주 사용하는 설정 예시입니다.

// UI를 1행으로 표시하여 디스플레이 영역을 늘림
default_layout "compact"
// Scroll 모드의 e로 여는 에디터
...

설정 가능한 항목은 Options, 키 변경은 Configuring Keybindings를 참조하세요.

Zellij에는 두 가지 공식 키 프리셋(Key Presets)이 있습니다.

Default preset에서는 Ctrl+o → c로 Configuration을 열어, 세션 중에만 또는 영구적으로 전환할 수 있습니다. 자세한 내용은 Keybinding Presets를 참조하세요.

추가적인 해결책은 공식 FAQ에 정리되어 있습니다.

첫날에는 Alt+n, Alt+h/j/k/l, Ctrl+t → n, Ctrl+o → d만으로도 충분합니다. 익숙해지면 플로팅 페인(Floating Pane), 입력 동기화(Input Synchronization), 레이아웃(Layout)을 추가하여 터미널 상의 작업 공간을 프로젝트 단위로 재현할 수 있게 됩니다.

Zellij는 화면 하단에 해당 상황의 치트시트를 항상 표시해 줍니다. 모든 것을 암기하려 하지 말고, 모드에 진입하여 후보를 확인하는 방식이 가장 자연스럽습니다.