cmux 검토 신호 훈련: 알림부터 세션 복원까지 30분 점검표

cmux란? 여러 AI 에이전트를 검토 대기열로 관리하는 법 표지

여러 코딩 에이전트를 띄우는 것보다 어려운 일은 어느 작업이 끝났고, 어느 작업이 사람의 판단을 기다리는지 놓치지 않는 것입니다. 창을 더 많이 여는 대신 알림이 도착하고, 사람이 해당 작업으로 이동하고, 검토 뒤 정리되는 한 바퀴부터 시험해야 합니다. 아래 훈련을 마치면 cmux workspace 하나에 테스트 알림과 재시작 메모가 남습니다.

0분: 시험용 workspace를 분리합니다

cmux 공식 시작 문서는 cmux를 Ghostty 기반 네이티브 macOS 터미널로 설명하며, 세로 탭, 알림 패널, 소켓 제어 API를 제공합니다. 요구 사항은 macOS 14 이상입니다. 시험은 실제 배포 저장소가 아닌 샘플 폴더에서 시작하세요. workspace 이름에 프로젝트와 과업을 함께 넣고, 첫 pane에는 터미널, 둘째 pane에는 확인할 페이지를 둡니다. 설치가 필요하면 공식 문서가 권장하는 DMG 절차를 우선 확인합니다.

5분: 사람이 돌아올 신호를 보냅니다

cmux 안의 터미널에서 다음 공식 CLI 예시를 실행합니다.

cmux notify --title "검토 요청" --body "샘플 작업 결과 확인"

알림 문서에 따르면 알림은 Received→Unread→Read→Cleared 순서로 이동합니다. ⌘⇧I는 알림 패널을 열고, ⌘⇧U는 가장 최근 unread 알림의 workspace로 이동합니다. 해당 workspace를 보는 순간 read가 되므로, read를 “검토 완료”로 해석하면 안 됩니다. 결과를 확인한 뒤에만 정리합니다.

10분: 대기열과 완료 기록을 구분합니다

공식 CLI 참조는 cmux list-notifications --json으로 알림을 조회하고 cmux clear-notifications로 모두 지우는 명령을 제공합니다. 전체 삭제는 되돌릴 검토 항목이 없는 시험에서만 사용하세요. 운영에서는 알림 제목에 프로젝트, 상태, 다음 행동을 넣고 별도의 이슈나 변경 기록을 결과의 영구 근거로 남깁니다. 알림 패널은 주의 전환 도구이지 감사 로그가 아닙니다.

15분: 브라우저에서 결과를 닫습니다

웹 결과가 있는 작업이라면 같은 workspace의 browser surface에서 제목, URL, 주요 문구를 확인합니다. 브라우저 자동화 문서는 스크립트용 구조화 getter와 사람 검토용 snapshot·screenshot을 구분합니다. 화면 캡처만 보고 DOM 상태를 추정하거나, DOM 조회만 보고 시각적 배치를 확정하지 마세요. 테스트 계정과 비운영 URL을 사용하고 결제·삭제·메일 발송 동작은 제외합니다.

20분: 복원되는 것과 재실행할 것을 적습니다

세션 복원 문서에 따르면 앱 재실행 뒤 창·workspace·pane 배치, 작업 디렉터리, 가능한 범위의 scrollback, 브라우저 URL과 기록이 복원됩니다. 임의의 실행 중 프로세스 메모리는 체크포인트하지 않습니다. 지원 에이전트도 hook이 네이티브 세션 ID를 잡았을 때만 재개될 수 있습니다. 따라서 workspace 메모에 개발 서버 재실행 명령, 확인 URL, 마지막 통과 테스트를 남깁니다.

자동 재개가 부담스러운 시험에서는 Settings > Terminal의 Resume Agent Sessions on Reopen을 끕니다. 공식 문서상 이 설정을 꺼도 레이아웃과 디렉터리 등의 복원은 유지됩니다. 앱을 한 번 종료·재실행하고, “화면 복원”과 “프로세스 재개”를 따로 판정하세요.

30분: 통과 여부를 한 줄로 적습니다

알림 도착 / unread 이동 / 결과 확인 / 기록 연결 / 재실행 메모 / 재시작 확인 여섯 항목 중 하나라도 실패하면 에이전트를 더 늘리지 않습니다. 모두 통과했을 때만 두 번째 workspace를 추가하세요. cmux의 가치는 창 수가 아니라 사람의 주의가 검토할 곳으로 정확히 돌아오는 데 있습니다.

확인한 공식 출처


CHAI:NUP 정보 기준

공식 자료와 최신 정보를 우선 확인하며, 변경 사항이 발견되면 내용을 업데이트합니다.

CHAI:NUP | 차이넙에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기