manaflow-ai/cmux

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

cmux란 무엇인가요?

cmux는 Ghost‑like ( Ghostty ) 렌더링 엔진을 기반으로 구축된 macOS 네이티브 터미널 애플리케이션입니다. 풍부한 UI 레이어를 추가하여 일반 터미널의 외관과 느낌을 유지하면서도 여러 터미널 창, 수직 사이드바, 인앱 브라우저를 사용할 수 있게 해줍니다. 핵심 장점은 AI 코딩 에이전트(Claude Code, Codex, OpenCode 등)가 입력을 기다리는 창을 강조 표시하는 알림 시스템으로, 올바른 창을 즉시 찾을 수 있습니다.

핵심 기능 (README 설명 기준)

기능	역할	AI 에이전트 작업에서의 중요성
알림 링 및 패널	에이전트의 주의가 필요할 때 창 주변에 파란색 링과 사이드바에 배지가 표시되며, 패널에 모든 대기 중인 알림이 나열됩니다.	수많은 분할 창 속에서도 어떤 에이전트가 대기 중인지 한눈에 파악할 수 있습니다.
수직 및 수평 탭	사이드바에 git 브랜치, PR 상태, 작업 디렉토리, 리스닝 포트, 최신 알림 텍스트를 표시합니다. 탭은 수직 및 수평으로 분할할 수 있습니다.	각 에이전트 세션 옆에 컨텍스트(브랜치, PR)를 제공하여 사고 전환을 줄여줍니다.
인앱 브라우저	agent‑browser 에서 포팅된 API를 통해 스크립트 작성이 가능한 분할 화면 브라우저 창입니다.	에이전트가 터미널을 떠나지 않고도 라이브 개발 서버와 상호 작용(클릭, 폼 작성, JS 실행)할 수 있습니다.
SSH 워크스페이스	`cmux ssh user@host`로 원격 워크스페이스를 생성합니다. 브라우저 창은 원격 네트워크를 통해 라우팅되며, scp를 통해 파일을 드래그 앤 드롭으로 업로드할 수 있습니다.	동일한 UI와 알림 경험을 유지하면서 원격 머신에서 에이전트를 실행할 수 있습니다.
Claude Code Teams 통합	`cmux claude‑teams`는 Claude Code 팀원을 사이드바 메타데이터가 포함된 네이티브 분할 창으로 생성합니다.	다중 에이전트 Claude 세션을 가시화하고 제어할 수 있게 합니다.
사용자 정의 명령어	`cmux.json`에서 프로젝트별 작업을 정의하여 명령 팔레트에 표시합니다.	일반적인 에이전트나 빌드 단계에 대한 빠른 원클릭 단축키를 제공합니다.
프로그래밍 가능한 CLI 및 socket API	워크스페이스 생성, 창 분할, 키 입력 전송, 브라우저 자동화 등을 수행합니다.	복잡한 워크플로우의 스크립트 작성이나 다른 도구와의 통합을 가능하게 합니다.
네이티브 macOS 앱 (Swift/AppKit)	Electron/Tauri를 사용하지 않으며, 빠른 시작, 낮은 메모리 사용량, libghostty를 통한 GPU 가속을 지원합니다.	무거운 코딩 세션에서도 더 나은 성능을 제공합니다.
Ghostty 호환성	기존 `~/.config/ghostty/config`를 읽어 테마, 폰트, 색상을 적용합니다.	현재 사용 중인 Ghostty 설정을 그대로 유지할 수 있습니다.
세션 복원	레이아웃, 디렉토리, 스크롤백, 브라우저 기록을 저장하며, 훅을 통해 에이전트 세션을 재개할 수 있습니다.	충돌이나 재시작 후에도 중단했던 지점부터 작업을 이어갈 수 있습니다.
크로스 플랫폼 확장	iOS 베타 클라이언트, Nightly 빌드, Homebrew Cask 설치 프로그램을 지원합니다.	설치와 초기 테스트가 간편합니다.

누가 사용하면 좋을까요?

여러 LLM 기반 코딩 에이전트(Claude Code, Codex, OpenCode 등)를 실행하며 어떤 에이전트가 입력을 기다리는지 확인해야 하는 개발자.
로컬 및 원격 머신 간에 에이전트를 오케스트레이션하는 팀 – SSH 워크스페이스를 통해 모든 것을 하나의 UI에서 관리할 수 있습니다.
스크립트 가능한 도구를 선호하는 파워 유저 – CLI/socket API를 통해 창 생성, 브라우저 작업, 알림을 자동화할 수 있습니다.
이미 Ghostty를 사용 중인 분 – 터미널을 바꾸지 않고도 테마를 유지하면서 추가적인 UI 기능을 사용할 수 있습니다.

설치 방법

DMG – GitHub 릴리스 페이지에서 최신 .dmg를 다운로드하여 애플리케이션 폴더로 드래그합니다(Sparkle을 통해 자동 업데이트).
Homebrew – brew tap manaflow-ai/cmux && brew install --cask cmux.
Nightly – 최신 main 브랜치를 테스트하기 위한 별도의 번들.

제한 사항 (README 기준)

현재는 macOS만 지원합니다(iOS 클라이언트는 베타 상태).
앱 자체는 AI 모델을 제공하지 않으며, 실행 중인 터미널 기반 에이전트를 호스팅하기만 합니다.
세션 복원은 라이브 프로세스 상태를 체크포인트하지 않으며, 레이아웃, 스크롤백, 브라우저 기록만 저장합니다.

빠른 시작 체크리스트

DMG 또는 Homebrew를 통해 설치합니다.
cmux를 실행하면 기존 Ghostty 테마가 자동으로 적용됩니다.
워크스페이스를 열고 (⌘ N) AI 코딩 에이전트(예: claude‑code)를 실행합니다.
에이전트가 입력을 기다릴 때 파란색 링과 사이드바 배지를 확인합니다.
⌘ Shift U를 사용하여 최신 읽지 않은 알림으로 이동합니다.
선택적으로 ~/.config/cmux/cmux.json에 프로젝트별 단축키를 추가합니다.

한 줄 요약: cmux는 사이드바, 알림 시스템, 분할 화면 브라우저, 프로그래밍 가능한 API를 추가하여 여러 AI 코딩 에이전트와의 작업을 더 원활하고 가시적으로 만들어주는 macOS 네이티브 터미널입니다.