cmux - Ghostty 기반 AI 코딩 에이전트 전용 macOS 터미널
목차
개요
cmux는 Ghostty 엔진 기반의 네이티브 Swift & AppKit macOS 터미널로, AI 코딩 에이전트에 최적화되어 있다. Claude Code 같은 AI 에이전트와 함께 작업할 때 필요한 알림 시스템, 세로 탭 UI, 내장 브라우저 등을 제공한다. GitHub에서 8.5k 스타를 기록하며 AI 시대의 터미널이 어떤 모습이어야 하는지를 보여주고 있다.
배경
AI 코딩 에이전트의 사용이 보편화되면서 기존 터미널의 한계가 드러나고 있다. 에이전트가 작업을 완료하거나 입력을 기다릴 때 알림이 부족하고, 여러 에이전트를 동시에 관리하기 어렵다. cmux는 이러한 문제를 해결하기 위해 Ghostty의 고성능 렌더링 엔진 위에 AI 에이전트 전용 기능을 구축했다. AGPL-3.0 라이선스로 공개되어 있다.
핵심 내용
주요 기능
cmux의 핵심 기능은 다음과 같다.
| 기능 | 설명 |
|---|---|
| GPU 가속 렌더링 | libghostty 기반의 부드러운 터미널 출력 |
| 세로 탭 UI | Git 브랜치, PR 상태, 작업 디렉터리, 포트 정보를 한눈에 표시 |
| 알림 링 시스템 | AI 에이전트 대기 시 파란색 링과 강조 표시 |
| 내장 브라우저 | 터미널과 웹뷰 분할 표시 |
| 스크립트 제어 | CLI 및 소켓 API를 통한 자동화 |
| 세션 복원 | 앱 재시작 시 레이아웃과 히스토리 자동 복원 |
Electron 앱 대비 빠른 실행 속도와 낮은 메모리 사용량이 특징이다. 세로 탭 UI는 기존 터미널의 가로 탭과 달리 Git 브랜치, PR 상태 등의 컨텍스트 정보를 즉시 확인할 수 있게 한다.
알림 시스템과 AI 에이전트 통합
cmux의 알림 시스템은 AI 에이전트와의 작업에 특화되어 있다. 에이전트가 입력을 기다리면 해당 패인에 파란색 링이 표시되고 사이드바에서 강조된다. Cmd+Shift+U로 가장 최근 미읽은 알림으로 바로 이동할 수 있다.
터미널 시퀀스(OSC 9/99/777)와 CLI 훅을 모두 지원하여 다양한 도구와 통합된다. 사이드바 알림 패널에서 모든 대기 중인 알림을 한눈에 확인할 수 있다.
내장 브라우저와 스크립트 제어
내장 브라우저는 터미널과 웹뷰를 분할 표시하여 별도의 브라우저 전환 없이 작업할 수 있게 한다. Vercel의 agent-browser 프로젝트에서 포팅된 API를 지원한다. 접근성 트리 스냅샷, 요소 상호작용, JavaScript 실행 등의 기능을 제공한다.
CLI와 소켓 API를 통해 워크스페이스 생성, 탭 관리, 키스트로크 제어, 패인 조작 등을 자동화할 수 있다. 이를 통해 커스텀 에이전트 통합 훅을 구축할 수 있다.
주요 단축키는 다음과 같다.
| 기능 | 단축키 |
|---|---|
| 새 워크스페이스 | Cmd+N |
| 사이드바 토글 | Cmd+B |
| 우측 분할 | Cmd+D |
| 하단 분할 | Cmd+Shift+D |
| 알림 표시 | Cmd+I |
| 스크롤백 클리어 | Cmd+K |
설치 및 설정
Homebrew를 통해 설치할 수 있다.
1
2
brew tap manaflow-ai/cmux
brew install --cask cmux
DMG 파일을 직접 다운로드하여 Applications 폴더에 드래그하는 방식도 지원한다. Sparkle 기반 자동 업데이트가 내장되어 있어 최신 버전을 유지할 수 있다.
기존 Ghostty 설정 파일(~/.config/ghostty/config)을 그대로 읽어 테마, 폰트, 색상 설정을 공유한다. 별도의 설정 파일을 만들 필요 없이 기존 Ghostty 사용자라면 바로 적용된다.
세션 복원 시 윈도우/패인 레이아웃, 작업 디렉터리, 터미널 스크롤백, 브라우저 히스토리가 복원된다. 다만 tmux 세션이나 vim 인스턴스 같은 활성 프로세스 상태는 복원되지 않는다.
macOS 전용으로 Apple Silicon과 Intel을 모두 지원한다. 현재 Windows 버전은 제공하지 않는다.
의미와 시사점
cmux는 AI 코딩 에이전트 시대에 터미널이 어떻게 진화해야 하는지를 보여주는 사례다. 기존 터미널은 사람이 직접 명령을 입력하는 것을 전제로 설계되었지만, AI 에이전트가 자율적으로 작업하는 환경에서는 알림, 상태 모니터링, 멀티 에이전트 관리 등 새로운 요구사항이 등장한다.
“The Zen of cmux”에서 강조하는 조합 가능한 기본 도구 중심 접근은 특정 워크플로우를 강요하지 않으면서도 다양한 에이전트와의 통합을 가능하게 한다. 좋은 터미널들이 Ghostty 엔진 기반으로 이동하는 추세도 주목할 만하다.
결론
cmux는 Ghostty 엔진의 고성능 렌더링 위에 AI 코딩 에이전트 전용 기능을 결합한 macOS 터미널이다. 알림 링 시스템, 세로 탭 UI, 내장 브라우저, 스크립트 API 등을 통해 AI 에이전트와의 협업 경험을 크게 개선한다. 조합 가능한 기본 도구 중심의 설계 철학으로 다양한 워크플로우에 유연하게 적응할 수 있다.