#시작하기

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

#설치

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

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

나중에 업데이트하려면:

brew upgrade --cask cmux

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

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

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는 레이아웃과 메타데이터만 복원합니다:

cmux는 아직 라이브 프로세스 상태를 복원하지 않습니다. Claude Code, tmux, vim 등의 활성 터미널 앱 세션은 앱 재시작 후 복원되지 않습니다.

See the session restore guide for agent hook setup and the supported resume matrix.