시작하기

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

설치

DMG (권장)

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

Homebrew

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

나중에 업데이트하려면:

brew upgrade --cask cmux

설치 확인

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

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

CLI 설정

cmux에는 자동화를 위한 커맨드라인 도구가 포함되어 있습니다. cmux 터미널 안에서는 자동으로 작동합니다. 다른 터미널에서 사용하려면 명령어 팔레트(⌘⇧P)를 열고 셸 명령어: PATH에 'cmux' 설치를 실행하세요. 번들된 CLI를 /usr/local/bin에 링크하며, 해당 폴더에 권한이 필요하면 관리자 암호를 묻습니다.

또는 심볼릭 링크를 직접 만드세요:

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를 기본 터미널로 설정

Finder에서 여는 ssh:// 링크와 셸 스크립트를 터미널 대신 cmux에서 열려면 메뉴 막대에서 cmux > cmux를 기본 터미널로 설정을 선택하거나, 명령어 팔레트에서 cmux를 기본 터미널로 설정을 실행하세요.

자동 업데이트

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

세션 복원 (현재 동작)

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

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

요구 사항

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