cmux4justn — cmux 워크스페이스를 프로젝트 기준으로 자동 정리하는 macOS CLI

cmux4justn: cmux 워크스페이스를 active project 기준으로 자동 정리하는 macOS CLI

cmux4justn — cmux 워크스페이스를 프로젝트 기준으로 자동 정리하는 macOS CLI

여러 프로젝트의 AI 코딩 에이전트를 cmux 터미널 위에 띄워두다 보면, "지금 어떤 프로젝트가 활성화되어 있는지"와 cmux의 workspace 목록이 자꾸 어긋나기 마련입니다. 새 프로젝트를 열 때마다 workspace를 수동으로 만들고, 끝난 프로젝트는 닫고, 이름도 매번 다르게 짓다 보면 금세 지저분해집니다.

cmux4justn은 바로 이 문제를 풀기 위해 만들어진 가벼운 macOS 전용 Bash 도구입니다. c4j라는 CLI 하나로 active project symlink 레지스트리와 cmux workspace를 자동으로 동기화해 줍니다. cmux를 매일 쓰는 개발자라면 한 번 설치해 두면 워크플로우가 한결 단단해집니다.

cmux4justn이 등장한 배경

cmux는 AI 코딩 에이전트를 위한 Ghostty 기반 macOS 터미널입니다. workspace 단위로 세션을 분리해 여러 에이전트를 동시에 운용할 수 있다는 큰 장점이 있습니다. 다만 프로젝트 수가 늘수록 "활성 프로젝트 목록"과 "실제 workspace"가 따로 노는 현상이 자주 생깁니다.

이 도구의 저자도 같은 문제를 직접 겪었습니다. "저를 위한 도구"라고 할 만큼, 실제 사용에서 발생하는 마찰을 정확히 짚고 그 해법을 코드로 풀어낸 점이 인상적입니다. 결과적으로 명령어 한두 줄로 active project 등록 → workspace 동기화 → 종료 정리까지 한 번에 끝낼 수 있습니다.

c4j 핵심 기능 살펴보기

c4j는 다섯 가지 서브커맨드로 구성되어 있습니다. 각 명령은 단순한 만큼 즉시 손에 익습니다.

• c4j add . — 현재 디렉터리를 active 프로젝트 목록에 추가합니다.

• c4j list — 등록된 active projects를 표 형태로 보여 줍니다.

• c4j sync — 변경 사항을 미리보기만 합니다. 실제 적용 전 검토용입니다.

• c4j sync --apply — cmux workspace를 실제로 생성·갱신·정리합니다.

• c4j delete . — active symlink를 제거하고, 대응하는 cmux workspace도 닫습니다.

추가로 c4j anchor 명령은 pinned anchor workspace를 보장해 줍니다. cmux에서 항상 열어두는 기본 작업 공간이 사라지지 않도록 고정하는 역할을 합니다. workspace 제목 prefix 설정과 결합하면 프로젝트별 가독성도 한층 좋아집니다.

# 현재 프로젝트를 active 목록에 추가c4j add .# 등록된 프로젝트 목록 확인c4j list# 변경 사항 미리보기c4j sync# 실제 cmux workspace에 반영c4j sync --apply# 프로젝트 종료 시 정리c4j delete .

설치와 기본 사용법

설치는 한 줄짜리 curl 스크립트로 끝납니다. 별도의 의존성 없이 macOS의 기본 Bash 환경에서 바로 동작합니다.

curl -fsSL https://raw.githubusercontent.com/bssm-oss/cmux4justn/main/install.sh | bash

설치가 끝나면 c4j 명령이 PATH에 등록됩니다. 새 프로젝트 폴더로 이동해 c4j add .만 입력하면 그 디렉터리가 active 레지스트리에 symlink로 기록됩니다. 이후 c4j sync --apply를 실행하면 cmux 측 workspace가 현재 active 목록과 일치하도록 자동 재구성됩니다.

c4j list의 출력 예시는 다음과 같습니다.

PROJECT                       PATH-----------------------------  ------------------------------------------------c4j                            /Users/justn/Workspaces/cmux4justnCodeAgora                      /Users/justn/Workspaces/CodeAgoracommander-agents               /Users/justn/Workspaces/commander-agents

PATH 컬럼이 정확히 보존되기 때문에, cmux 안에서 어느 워크스페이스로 이동하든 일관된 위치를 유지할 수 있습니다.

실전 워크플로우 팁

실무에서 c4j를 가장 잘 활용하려면 다음 순서로 습관화하는 것이 좋습니다.

먼저, 새 프로젝트를 열 때마다 c4j add .로 즉시 등록합니다. 한 번 등록해 두면 다음부터는 c4j sync --apply만으로 끝납니다. 등록을 미루면 잊어버리기 쉽고, 결국 수동 정리에 시간을 낭비하게 됩니다.

두 번째로, 큰 작업 단위로 anchor workspace를 지정합니다. 예를 들어 "개인 사이드 프로젝트", "회사 메인 레포", "실험용 샌드박스" 정도를 anchor로 고정해 두면 cmux를 껐다 켜도 핵심 작업 공간이 사라지지 않습니다.

세 번째로, 프로젝트가 끝나면 c4j delete .로 정리합니다. active 레지스트리와 cmux workspace가 함께 닫히기 때문에 누수가 생기지 않습니다. 이 습관 하나가 cmux를 장기적으로 깔끔하게 유지하는 핵심입니다.

마지막으로, 동기화 전에 c4j sync로 미리보기를 한 번 확인하는 습관을 들입니다. 의도치 않은 삭제를 막을 수 있고, prefix 설정이 어떻게 반영되는지 시각적으로 검증할 수 있습니다.

c4j 워크플로우: add → list → sync → delete

마무리: 향후 전망과 활용 팁

cmux4justn은 작지만 정확한 문제 해결 도구입니다. AI 코딩 에이전트를 여러 프로젝트에서 동시에 굴리는 개발자라면, c4j 한 줄이 cmux의 혼돈을 단단한 루틴으로 바꿔 줍니다. macOS와 Bash에 한정되어 있다는 점은 한계처럼 보이지만, 동시에 의존성을 최소화해 설치를 가볍게 유지한다는 강점이기도 합니다.

앞으로는 prefix 규칙 자동화나 다중 cmux 인스턴스 지원 같은 확장이 기대됩니다. 지금은 "내가 쓰는 도구를 내가 정리한다"는 단순한 철학이 충분히 매력적입니다. cmux를 매일 켜는 분이라면, 오늘 한 번 c4j add .부터 시작해 보길 권합니다.