cmux

어떤 작업에 쓰는 프로그램인가

cmux는 Mac에서 여러 프로젝트의 셸, 개발 서버, 테스트와 AI 코딩 에이전트를 함께 실행하는 개발자를 위한 터미널이다. 자체 AI 모델을 제공하는 도구라기보다 명령줄 도구를 배치하고 상태를 확인하는 작업 공간에 가깝다. 터미널에서 실행되는 Claude Code, Codex 등의 도구를 사용할 수 있다.

Ghostty를 복제한 프로그램은 아니며, libghostty를 터미널 렌더링 라이브러리로 사용한다. Swift와 AppKit으로 만든 데스크톱 앱이고, 공식 시작 문서의 요구 사항은 macOS 14.0 이상과 Apple Silicon 또는 Intel Mac이다.

작업을 구분하고 필요한 순간에 돌아오기

프로젝트마다 워크스페이스를 나누면 사이드바의 브랜치·디렉터리·포트 정보로 현재 작업을 구별할 수 있다. 한 워크스페이스 안에서는 에이전트, 서버 로그, 테스트를 각각 분할 패널에 놓고 내장 브라우저를 함께 열 수 있다.

알림은 프로그램이 보내는 OSC 9/99/777 시퀀스나 cmux CLI·에이전트 훅을 통해 발생한다. 단순히 모든 셸 작업의 완료를 자동 판별한다고 기대하면 안 된다. 미확인 알림이 생기면 Cmd+Shift+U로 해당 작업에 빠르게 이동할 수 있다.

설치와 첫 작업 순서

공식 홈페이지에서 Mac용 DMG를 내려받아 열고 cmux를 응용 프로그램 폴더로 옮기는 방식이 권장된다. 처음 실행한 뒤 왼쪽 사이드바와 초기 워크스페이스가 보이는지 확인하고, 프로젝트 디렉터리로 이동해 평소 사용하는 명령을 실행한다.

Cmd+N으로 워크스페이스를 추가하고 Cmd+D로 오른쪽 패널, Cmd+Shift+D로 아래쪽 패널을 만든다. Cmd+Shift+L은 브라우저 분할을 연다. 외부 터미널에서도 cmux CLI를 쓰려면 명령 팔레트의 Shell Command: Install 'cmux' in PATH를 이용한다. 업데이트는 Sparkle로 확인하며 메뉴의 Check for Updates에서도 점검할 수 있다.

실무 활용 예시

웹 서비스의 로그인 오류를 수정한다면 로그인 작업용 워크스페이스를 만들고 첫 패널에서 코딩 에이전트, 두 번째 패널에서 개발 서버, 세 번째 패널에서 테스트를 실행하는 구성이 가능하다. 옆 브라우저에는 로컬 개발 주소를 열어 수정 결과를 확인한다.

다른 프로젝트 작업을 보다가 로그인 작업의 입력 요청 알림이 나타나면 해당 워크스페이스로 돌아온다. 반복하는 배치는 CLI로 자동화할 수 있지만, 먼저 수동으로 디렉터리와 실행 명령이 맞는지 확인하는 편이 좋다. 이는 공식 기능을 바탕으로 구성한 활용 예시이며 직접 사용한 후기는 아니다.

무료 사용과 유료 항목의 범위

공식 홈페이지는 cmux 데스크톱 앱을 무료로 안내하며, 공식 저장소는 앱의 GPL-3.0-or-later 라이선스를 명시한다. 확인한 자료에는 기본 터미널의 사용 시간이나 워크스페이스 수를 제한하는 무료판 조건이 제시되어 있지 않다.

별도의 Founder's Edition은 개발 후원과 cmux AI, iOS 앱, Cloud VMs 등의 조기 접근을 안내한다. iOS 동반 앱은 베타이므로 Mac용 정식 앱과 구분해야 한다. 저장소는 일부 서버 소프트웨어에 별도 라이선스와 상용 이용 조건을 명시하므로, 서버 자체 호스팅까지 데스크톱 무료 사용과 같은 조건으로 판단하면 안 된다.

문제가 생겼을 때 확인할 순서

알림이 보이지 않으면 먼저 앱 안의 미확인 배지와 알림 목록을 확인한다. 공식 문서상 cmux 창이 포커스를 받거나 해당 워크스페이스가 활성 상태이거나 알림 패널이 열려 있으면 데스크톱 알림이 억제된다. 다음으로 에이전트 훅 또는 OSC 알림 전송 설정과 macOS 알림 허용 상태를 점검한다.

외부 셸에서 cmux 명령을 찾지 못하면 PATH 등록을 확인한다. 재실행 후 화면은 돌아왔는데 작업이 멈췄다면 레이아웃 복원과 프로세스 보존을 구분해야 한다. 일반 셸·vim·tmux의 실행 상태를 임의로 저장하는 방식은 아니며, 지원 에이전트 재개도 훅이 세션 ID를 저장한 경우에 가능하다.

다른 도구와 선택 기준 및 검토 상태

Mac에서 프로젝트별 시각적 구분, 알림과 브라우저를 한 창에 묶으려면 cmux의 구성이 맞는다. Ghostty 자체의 터미널 기능을 중심으로 쓰고 싶다면 사이드바와 자동화 기능이 실제로 필요한지 비교하면 된다. 원격 작업에서는 cmux와 SSH·tmux를 함께 사용하는 구성도 공식 안내에 포함되어 있다.

2026-10-07 확인한 공식 최신 배포 페이지는 v0.65.0을 표시해 제공된 버전과 일치했다. 공식 문서와 배포 자료에서 지원 종료 공지는 확인되지 않았다. 다만 웹 문서는 특정 버전에 고정되어 있지 않으므로 세부 기능은 설치할 배포판에서 다시 확인할 필요가 있다.

공식 안내

• cmux — The terminal built for multitasking, organization, and programmability · 확인 2026-10-07
• Getting Started — macOS — cmux docs · 확인 2026-10-07
• Notifications — macOS — cmux docs · 확인 2026-10-07
• Keyboard Shortcuts — cmux docs · 확인 2026-10-07
• manaflow-ai/cmux — 공식 저장소 README · 확인 2026-10-07
• Release v0.65.0 · manaflow-ai/cmux · 확인 2026-10-07