using-cmux

Claude Code 플러그인 — cmux(macOS용 Ghostty 기반 AI 코딩 터미널)를 Claude가 헷갈리지 않고 다루게 해주는 skill과 두 개의 슬래시 커맨드.

제공하는 것

Skill: using-cmux

Claude가 cmux 안에서 뛰고 있다고 판단되면(CMUX_SOCKET_PATH가 설정되어 있거나 사용자가 cmux/pane/surface를 언급하면) 자동으로 발동한다.

주요 내용:

• 환경 감지 (CMUX_SOCKET_PATH) — 바깥이면 즉시 중단
• 개념 계층 Window > Workspace > Pane > Surface
• 카테고리별 핵심 CLI 표 (조회 / 생성·이동 / I/O / 알림·상태 / 브라우저 / 기타)
• tmux → cmux 변환 매핑
• 함정 정리 (send가 엔터 안 침, id는 세션마다 바뀜, 등)
• 구현 ↔ 리뷰 pane 핸드오프 워크플로우

상세 레퍼런스는 progressive disclosure로 분리:

• skills/using-cmux/references/cli-cheatsheet.md — 전체 CLI/플래그 레퍼런스
• skills/using-cmux/references/ai-orchestration.md — 구현 ↔ 리뷰 메시지 패싱 프로토콜

Slash commands

• /cmux-here — 지금 내가 어느 workspace/pane/surface인지, 이웃 pane이 뭐가 있는지 한눈에
• /cmux-ask <surface> <prompt> — 다른 pane에 프롬프트 주입 + 엔터 자동

핵심 워크플로우: 구현 ↔ 리뷰 핸드오프

폴링이나 무한 루프 없이, 턴제 메시지 패싱으로 두 pane을 협업시킨다.

1. 구현 pane에서 플랜/구현
2. 구현 pane → 리뷰 pane으로 리뷰 요청 주입 (완료 신호 문구 포함)
3. 리뷰 pane이 리뷰 끝나면 구현 pane에 완료 신호 주입 (예: 리뷰했어. 확인해)
4. 구현 pane이 그 신호 보고 리뷰 pane read-screen → 개발자에게 피드백 요약 출력
5. 정지 — 개발자가 직접 결정 (반영할지 / 재리뷰할지 / 무시할지)

자동 수정·자동 재리뷰는 하지 않는다. 개발자가 운전한다.

설치

giwonn-plugins marketplace에 등록되어 있다면:

/plugin install using-cmux@giwonn-plugins

직접 설치:

/plugin install giwonn/using-cmux

요구사항

• macOS + cmux 앱 실행 중
• cmux CLI가 PATH에 있음 (앱 최초 실행 시 /usr/local/bin/cmux로 설치됨)
• Claude Code

라이선스

MIT