cmuxcmux/docs

시작하기

cmux는 여러 AI 코딩 에이전트를 관리하기 위해 Ghostty 기반으로 구축된 경량 네이티브 macOS 터미널입니다. 세로 탭, 알림 패널, 소켓 기반 제어 API를 제공합니다.

설치

DMG (권장)

Mac용 다운로드

.dmg 파일을 열고 cmux를 응용 프로그램 폴더로 드래그하세요. cmux는 Sparkle을 통해 자동 업데이트되므로 한 번만 다운로드하면 됩니다.

Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux

나중에 업데이트하려면:

brew upgrade --cask cmux
처음 실행할 때 macOS가 확인된 개발자의 앱을 열지 확인할 수 있습니다. 열기를 클릭하여 진행하세요.

설치 확인

cmux를 열면 다음이 표시됩니다:

  • 왼쪽에 세로 탭 사이드바가 있는 터미널 창
  • 이미 열려 있는 하나의 초기 워크스페이스
  • 입력 준비가 된 Ghostty 기반 터미널

CLI 설정

cmux에는 자동화를 위한 커맨드라인 도구가 포함되어 있습니다. cmux 터미널 안에서는 자동으로 작동합니다. cmux 외부에서 CLI를 사용하려면 심볼릭 링크를 만드세요:

sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux

그러면 다음과 같은 명령을 실행할 수 있습니다:

cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"

자동 업데이트

cmux는 Sparkle을 통해 자동으로 업데이트를 확인합니다. 업데이트가 있으면 타이틀바에 업데이트 알림이 표시됩니다. 메뉴 바에서 cmux > 업데이트 확인을 통해 수동으로 확인할 수도 있습니다.

세션 복원 (현재 동작)

재시작 후 cmux는 레이아웃과 메타데이터만 복원합니다:

  • 창, 워크스페이스, 패널 레이아웃
  • 작업 디렉토리
  • 터미널 스크롤백 (최선의 노력)
  • 브라우저 URL 및 탐색 기록
cmux는 아직 라이브 프로세스 상태를 복원하지 않습니다. Claude Code, tmux, vim 등의 활성 터미널 앱 세션은 앱 재시작 후 복원되지 않습니다.

요구 사항

  • macOS 14.0 이상
  • Apple Silicon 또는 Intel Mac