AI 코딩 에이전트 작업을 정리하는 오픈소스 macOS 터미널, cmux

AI 요약

cmux는 여러 코딩 에이전트를 동시에 실행하는 개발자를 위한 macOS 터미널입니다. Swift와 AppKit으로 만들었으며, Ghostty를 포크하지 않고 libghostty를 터미널 렌더링 라이브러리로 사용합니다. 기존 Ghostty 설정에서 테마와 글꼴, 색상, 키 바인딩을 읽어 옵니다. Electron이나 Tauri 기반 오케스트레이터 대신 터미널과 조합 가능한 도구를 제공한다는 것이 제작자가 설명하는 설계 방향입니다.

에이전트 알림과 작업 공간

사이드바의 세로 탭에는 Git 브랜치, 연결된 PR 상태와 번호, 작업 디렉터리, 리스닝 포트, 마지막 알림 내용이 표시됩니다. 작업 공간을 가로·세로로 나눌 수 있으며, 에이전트가 입력을 기다리면 해당 패널에 파란 테두리가 나타나고 탭에 읽지 않은 알림 표시가 켜집니다. 알림은 OSC 9, 99, 777 터미널 시퀀스를 감지하거나 cmux notify 명령과 에이전트 훅으로 보냅니다. 알림을 모아 보는 패널도 제공하며 Cmd+Shift+U로 가장 최근의 읽지 않은 항목으로 이동합니다.

터미널과 브라우저 자동화

터미널 옆에 브라우저 패널을 분할해 띄울 수 있습니다. 브라우저는 접근성 트리나 DOM을 확인하고, 요소를 찾아 클릭하거나 입력하며, JavaScript를 실행하는 스크립트 API를 제공합니다. 같은 소켓 API에서 콘솔과 네트워크 활동도 읽을 수 있어 에이전트가 개발 서버를 확인하는 작업을 자동화할 수 있습니다. Chrome, Firefox, Arc 등 20개가 넘는 브라우저에서 쿠키와 방문 기록, 세션을 가져오는 기능도 있습니다.

CLI와 Unix 소켓 API로 작업 공간과 탭을 만들고, 패널을 나누고, 키 입력을 보내거나 브라우저 URL을 열 수 있습니다. 프로젝트별 명령은 cmux.json에 정의해 명령 팔레트에서 실행합니다. SSH 연결로 원격 작업 공간을 만들면 브라우저 패널도 원격 네트워크를 사용해 원격 개발 서버의 localhost에 접근합니다. 원격 세션에 이미지를 끌어 놓아 SCP로 전송하는 기능도 안내합니다. Claude Code 팀 모드에서는 팀원을 네이티브 분할 패널로 표시하고, tmux 없이 각 팀원의 상태와 알림을 볼 수 있습니다.

세션 복원과 제한

앱을 다시 열면 창과 작업 공간, 패널 배치, 작업 디렉터리, 가능한 범위의 터미널 스크롤백, 브라우저 URL과 방문 기록을 복원합니다. 지원 에이전트는 훅이 저장한 세션 ID를 사용해 재개할 수 있습니다. 다만 임의의 실행 프로세스를 그대로 살려 두지는 않습니다. 앱 종료나 충돌 뒤에도 프로세스를 이어야 한다면 로컬 tmux 또는 zellij 연동을 선택할 수 있지만, 로컬 세션은 로그아웃이나 Mac 재시작, 전원 차단을 견디지 못합니다. 기기가 오프라인인 동안에도 원격 작업을 유지하려면 SSH·Mosh 또는 계속 실행되는 클라우드 VM이 필요합니다.

세션 복원 명령은 신뢰 범위를 구분합니다. 같은 cmux 설치의 저장 세션은 신뢰된 상태로 복원하지만, 파일 경로에서 가져온 세션은 신뢰하지 않습니다. 이 경우 레이아웃과 작업 디렉터리, 텍스트 스크롤백, HTTP(S) 브라우저 탭만 복원하며 명령을 자동 실행하지 않습니다. 토큰·비밀번호·API 키 같은 민감한 환경 변수는 재개 명령을 저장하기 전에 제외합니다. 사용자가 승인한 명령 접두어나 실행 중인 프로세스에서 확인한 tmux 명령만 자동 재개 대상으로 삼습니다.

설치와 라이선스

cmux는 macOS 전용이며 GitHub에서 소스 코드를 공개합니다. 앱은 GPL-3.0-or-later 라이선스를 따릅니다. 다만 web/, Cloudflare Workers, 라이선스 파일에 명시한 릴레이 서비스 등 서버 소프트웨어에는 Business Source License 1.1을 적용합니다. 해당 서버 코드는 비상업적 용도로 실행할 수 있으며, 프로덕션 사용이나 자체 호스팅에는 상용 라이선스가 필요합니다. 앱은 DMG 또는 Homebrew Cask로 설치하며, Sparkle을 통한 자동 업데이트를 지원합니다.

원문: GitHub / 번역·요약: Trawling