Ghostty 기반 맥 터미널 cmux, AI 코딩 에이전트 2.8만 명이 선택한 이유
여러 AI 코딩 에이전트를 동시에 띄워두면 알림은 쏟아지는데 맥락이 안 보여 결국 탭을 헤매게 됩니다. cmux는 Ghostty 위에 세로 탭과 알림 패널, 인앱 브라우저를 얹어 에이전트별 컨텍스트를 한눈에 파악하게 합니다. 이 자료는 설치부터 SSH 워크스페이스, Claude Code Teams 연동까지 실무 흐름에 맞춰 다룹니다.
Claude Code, Codex, Gemini 등 여러 AI 에이전트를 병렬로 돌리다 보면 '누가 날 부르는지' 알림만으로는 부족함을 느낍니다. cmux는 Ghostty 기반 네이티브 맥 터미널로, 세로 탭과 알림 링, 인앱 브라우저까지 합쳐 에이전트 워크스페이스를 하나의 창에서 끝내게 해줍니다.
cmux란 무엇인가요
cmux는 Ghostty 엔진 위에 올라간 macOS 네이티브 터미널이자 AI 코딩 에이전트 전용 워크스페이스 매니저예요. 2.8만 개 스타를 받은 오픈소스 프로젝트로, Swift로 작성돼 맥에서 가장 가볍고 빠른 반응성을 보여줍니다. 기존 Ghostty에 세로 탭, 알림 링, 브라우저 분할, SSH 워크스페이스 같은 기능을 얹어 여러 에이전트 세션을 동시에 돌릴 때 생기는 '어디서 알림이 왔지?' 문제를 해결했어요.
주요 기능 한눈에 보기
| 기능 | 설명 |
|---|---|
| 세로·가로 탭 | 사이드바에 git 브랜치, PR 상태/번호, 작업 디렉터리, 리스닝 포트, 최신 알림 텍스트 표시 |
| 알림 링·패널 | 에이전트 입력 대기 시 파란 링 + 탭 하이라이트, 미읽기 알림만 모아 한 번에 점프 |
| 인앱 브라우저 | agent-browser API 포트로 터미널 옆 브라우저 분할, 스크립터블 제어 가능 |
| SSH 워크스페이스 | cmux ssh user@host로 원격 머신 전용 워크스페이스 생성, --command로 초기 명령 실행, 로컬호스트 라우팅·이미지 드래그 업로드 지원 |
| Claude Code Teams | cmux claude-teams로 팀원 모드 원클릭 실행 |
| 자동 업데이트 | DMG 설치 시 Sparkle 채널로 백그라운드 업데이트 |
설치는 DMG 드래그·드롭(권장) 또는 brew install --cask cmux 한 줄이면 끝납니다. 처음 실행할 때 '확인되지 않은 개발자' 경고가 뜨면 '열기'만 누르면 돼요. 9개월 전(2026년 1월) 처음 만들어져 이번 달(2026년 10월)까지 꾸준히 업데이트되고 있으며, 포크 2,458개·이슈·PR 활동도 활발해 실무 도입 리스크가 낮습니다.
자주 묻는 질문
Q. Ghostty 설정 파일 그대로 쓸 수 있나요?
A. 네. cmux는 Ghostty 설정을 상속받아 ~/.config/ghostty/config를 그대로 읽습니다.
Q. tmux·screen 세션과 공존되나요?
A. 네. cmux 탭 안에서 tmux attach 등을 자유롭게 쓸 수 있고, 세로 탭은 tmux 창·페인과 독립적으로 동작합니다.
Q. Windows·Linux 지원 계획은요? A. 현재는 macOS 전용이며, README에 타 플랫폼 계획은 명시돼 있지 않습니다.
왜 cmux를 쓰나요
manafow-ai/cmux는 Ghostty 엔진 위에서 동작하는 macOS 전용 터미널입니다. AI 코딩 에이전트와의 협업을 위해 수직 탭, 알림 링, 인앱 브라우저 등 다양한 기능을 제공하며, 9개월 전(2026년 1월)에 처음 공개되었습니다. 현재는 27,764개의 스타(2.8만 개)와 2,458개의 포크를 보유하고 있으며, 주 언어는 Swift입니다. 주요 주제 태그에는 amp, claude-code, cli, coding-agents, gemini, macos, multiplexer, multitasking, programmability, terminal, workspace-manager 등이 포함됩니다.
주요 기능은 다음과 같습니다.
• 알림 링: 에이전트가 주의를 요할 때 탭과 패널이 파란색으로 표시됩니다.
• 알림 패널: 한눈에 모든 대기 알림을 확인하고 바로 이동할 수 있습니다.
• 인앱 브라우저: 스크립터블 API를 이용해 터미널과 병렬로 브라우저를 띄울 수 있습니다.
• 수직·수평 탭: Git 브랜치, PR 상태, 작업 디렉터리, 포트, 알림 텍스트를 사이드바에 표시합니다.
• SSH: cmux ssh user@remote 명령으로 원격 머신에 워크스페이스를 만들 수 있고, --command 옵션을 통해 초기 명령을 실행합니다.
• Claude Code Teams: cmux claude-teams 명령으로 Claude Code 팀 모드를 실행합니다.
- 💡 27,764개의 스타 (2.8만 개)
- 🔄 2,458개의 포크
- 🗓️ 2026년 1월에 최초 공개, 2026년 10월에 최신 업데이트
- 🏗️ Swift 기반 개발
- 📦 오픈소스(라이선스 명시 없음)
- 🔧 Git, PR, 포트 정보 표시 기능 포함
설치와 첫 실행
cmux를 맥에 설치하는 방법은 두 가지가 있어요. DMG 파일을 쓰는 방식(권장)과 Homebrew로 설치하는 방식이죠. 어떤 걸 쓰든 최초 실행 시 게이트키퍼 허용만 한 번 해주면 바로 쓸 수 있습니다.
1) DMG로 설치하기 (권장)
공식 저장소의 Releases 페이지에서 최신 .dmg 파일을 내려받으세요. 다운로드한 파일을 열면 cmux 아이콘이 보이는데, 이를 Applications 폴더로 드래그하면 끝입니다. cmux는 Sparkle 자동 업데이트를 쓰기 때문에 한 번만 설치해두면 이후 버전은 앱 안에서 알아서 갱신돼요.
2) Homebrew로 설치하기
brew install --cask cmux나중에 업데이트하려면 아래 명령어를 쓰세요.
brew upgrade --cask cmux3) 최초 실행 — 게이트키퍼 허용
설치 방법과 상관없이 처음 앱을 열 때 macOS가 "확인되지 않은 개발자" 경고를 띄울 수 있어요. 당황하지 말고 대화상자에서 ‘열기’ 버튼을 누르면 정상 실행됩니다. 이 과정은 최초 1회만 필요해요.
주의할 점과 팁
cmux는 macOS 전용 터미널이며 Swift 로 작성된 네이티브 앱입니다. 가로·세로 탭이 동시에 가능하고, AI 코딩 에이전트와의 협업에 특화된 알림 링과 인앱 브라우저 기능이 포함돼 있습니다. 설치 방법은 두 가지가 있는데, 가장 간편한 방법은 DMG 파일을 열어 Applications 폴더로 드래그하는 것입니다. DMG 설치 시 첫 실행 시 macOS가 “신뢰할 수 있는 개발자”를 확인하도록 요청할 수 있는데, Open 버튼을 눌러 진행하면 됩니다. Homebrew 를 선호하시는 경우는 brew install --cask cmux 로 설치하고, 이후 업데이트는 brew upgrade --cask cmux 로 진행하면 됩니다.
cmux는 Sparkle 을 통해 자동으로 업데이트됩니다. 따라서 별도의 수동 업데이트가 필요 없으며, 새 버전이 배포되면 앱이 자동으로 최신 상태로 유지됩니다. 라이선스 정보는 저장소에 명시되지 않았으므로 사용 전에 사내 정책에 맞게 검토하시는 것이 좋습니다. 현재 GitHub 저장소에는 27,764개의 스타(한국어로 2.8만 개)가 부여되어 있으며, 최초 커밋은 9개월 전(2026년 1월)에 이루어졌고, 최근 업데이트는 이번 달(2026년 10월)에 이루어졌습니다.
- macOS 전용이므로 macOS 환경에서만 사용 가능합니다.
- Swift 기반으로 개발되어 가벼운 실행과 높은 성능을 보장합니다.
- Sparkle 을 통해 자동 업데이트가 제공됩니다.
- 라이선스 정보가 명시되지 않아 사용 전 검토가 필요합니다.
- 현재 GitHub 스타 수는 27,764개(2.8만 개)이며, 업데이트 주기가 짧습니다.