cmux: AI 코딩 에이전트 멀티태스킹을 위한 Ghostty 기반 macOS 네이티브 터미널

오픈소스 개발팀 manaflow-ai가 다중 AI 코딩 에이전트의 병렬 실행과 멀티태스킹 관리에 특화된 오픈소스 macOS 네이티브 터미널 'cmux'를 공개했습니다. Swift와 AppKit으로 작성된 네이티브 인터페이스 위에 libghostty 엔진을 결합하여, Claude Code와 Codex 등 장시간 자율 실행되는 코딩 에이전트들을 모니터링하고 제어할 수 있도록 설계된 개발자 도구입니다.

이미지 출처: manaflow-ai/cmux

기존 터미널 에뮬레이터 환경에서는 여러 AI 코딩 에이전트를 동시에 실행할 때 각 세션의 진행 상태를 파악하기 어려웠습니다. 에이전트가 도구 실행 승인이나 사용자 입력을 대기하며 멈춰 있어도 이를 제때 알아채기 힘들었고, 다수의 창이나 탭을 오가며 현재 Git 브랜치와 로컬 포트, 작업 디렉토리를 일일이 확인해야 하는 컨텍스트 전환 비용이 컸습니다. cmux는 이러한 문제를 해결하기 위해 에이전트 상태 시각화, 작업 공간별 메타데이터 표시, 스크립터블 브라우저를 단일 작업 공간에 통합했습니다.

libghostty GPU 가속 렌더링과 Swift·AppKit 네이티브 아키텍처

cmux의 핵심 렌더링 파이프라인은 고성능 터미널 에뮬레이터 Ghostty의 코어 라이브러리인 libghostty를 기반으로 구현되었습니다.

• GPU 가속 터미널 렌더링: 대량의 로그와 에이전트 실행 출력이 빠르게 쏟아지는 환경에서도 지연 없는 고주사율 텍스트 렌더링을 제공합니다.
• 기존 Ghostty 설정 호환: 사용자의 기존 ~/.config/ghostty/config 설정 파일을 그대로 인식하고 적용하므로, 기존 Ghostty 사용자는 폰트, 테마, 키바인딩을 재설정할 필요 없이 즉시 전환할 수 있습니다.
• 경량 네이티브 구현: Electron 등 웹 기술 기반 래퍼가 아닌 Swift와 AppKit으로 구축되어 macOS 메모리 점유율을 낮추고 즉각적인 UI 반응성을 유지합니다.

AI 에이전트 작업 대기 알림 링과 수직 탭 워크스페이스 메타데이터

cmux는 에이전트가 사람의 개입을 필요로 하는 순간을 시각적·프로토콜 단위로 감지합니다.

• 파란색 알림 링(Notification Ring): Claude Code나 Codex 등 코딩 에이전트가 사용자 입력이나 도구 실행 승인을 대기할 때, 해당 터미널 패널 주변에 파란색 링이 표시되고 사이드바 탭이 점등되어 즉각적인 확인을 유도합니다.
• 표준 이스케이프 시퀀스 및 CLI 연동: 터미널 표준인 OSC 9, OSC 99, OSC 777 알림 시퀀스를 지원하며, CLI 기반 알림 트리거를 통해 다양한 자동화 스크립트 및 커스텀 에이전트와 연동할 수 있습니다.
• 수직 사이드바 탭 메타데이터: 창 좌측의 수직 탭 영역에는 각 워크스페이스별 Git 브랜치, 연결된 Pull Request(PR) 상태 및 번호, 현재 작업 디렉토리, 바인딩된 활성 로컬 포트, 최신 알림 메시지가 실시간으로 집계되어 표시됩니다. 개발자는 여러 탭을 클릭해 전환하지 않고도 각 프로젝트의 작업 현황을 한눈에 파악할 수 있습니다.

agent-browser 기반 스크립터블 인앱 브라우저와 자동화 연동

cmux는 터미널 패널 분할 뷰 내부에 agent-browser 기반의 스크립터블 인앱 브라우저를 내장하고 있습니다.

• 로컬 웹 DOM 직접 상호작용: AI 에이전트가 로컬 개발 서버에서 구동 중인 웹 애플리케이션의 DOM 트리와 직접 상호작용하고 렌더링 결과를 확인할 수 있습니다.
• 자동화 테스트 및 피드백 루프: 에이전트가 코드를 수정한 뒤 외부 브라우저를 따로 띄우지 않고도 cmux 내부 분할 브라우저를 통해 실시간 UI 변경 사항을 점검하고 E2E 자동화 검증을 완결할 수 있습니다.
• 프로그래머블 분할 패널: 단축키와 CLI를 통해 터미널 패널과 브라우저 패널을 유연하게 분할·재배치할 수 있어 복합 멀티태스킹 작업 공간을 구축할 수 있습니다.

설치 방법 및 실무 도입 시 고려사항

cmux는 macOS 환경을 위해 두 가지 공식 설치 경로를 제공합니다.

• Homebrew Cask 설치: 터미널에서 brew install --cask cmux 명령을 실행해 설치할 수 있습니다.
• DMG 직접 설치: 공식 배포 DMG 파일을 통해 설치할 수 있으며, 내장된 Sparkle 프레임워크를 통해 앱 내 자동 업데이트를 지원합니다.

도입 전 확인해야 할 환경 제약과 주의 사항은 다음과 같습니다.

• macOS 전용 플랫폼 제약: Swift 및 AppKit 네이티브 코드로 제작되어 현재 macOS 환경에서만 동작하며, Windows 및 Linux는 지원하지 않습니다.
• 대형 저장소 및 관리형 Mac 설정: 모노레포 등 파일 수가 극도로 많은 대형 저장소나 기업 보안 에이전트가 적용된 관리형 Mac 환경에서는 파일 감시 부하를 방지하기 위해 CMUX_NO_GIT_WATCH=1 환경변수를 설정하여 Git 감시자 프로세스의 리소스 사용량을 제어하는 것이 권장됩니다.

출처

• manaflow-ai/cmux GitHub 저장소
• cmux 공식 웹사이트