ccmux

<p align="center"> <img src="docs/demo.png" alt="ccmux demo" width="800"> </p>

동시 실행되는 Claude Code 세션들을 조율하기 위한 간소화된 터미널 UI (Terminal-UI)입니다.

특징 (Features)

• 시각적 사이드바 (Visual sidebar) — 모든 세션을 한눈에 확인; Claude가 사용자의 주의를 필요로 할 때 빨간색 강조 표시로 즉시 알림
• CLI 세션 관리 (CLI session management) — 터미널에서 세션 생성, 목록 확인, 활성화, 제거
• Git 워크트리 격리 (Git worktree isolation) — 격리된 브랜치에서 중복 세션 실행; ccmux.toml 파일을 사용하여 워크트리(worktree) 생성 시 추적되지 않는 빌드 의존성 설정과 같은 추가 단계 추가 가능

사전 요구 사항 (Prerequisites)

ccmux를 설치하기 전에 다음 사항이 준비되었는지 확인하세요:

1. tmux — 터미널 멀티플렉서 (Terminal multiplexer)

   # Ubuntu/Debian
   sudo apt install tmux
   # macOS
   

...

2. **Claude Code** — Anthropic의 Claude용 CLI
   ```bash
   npm install -g @anthropic-ai/claude-code

자세한 내용은 Claude Code documentation을 참조하세요.

설치 (Installation)

# 권장 사항
pipx install ccmux

...

빠른 시작 (Quick Start)

ccmux             # 현재 디렉토리에 대한 세션을 자동 생성하거나 기존 세션에 연결
ccmux new         # 현재 디렉토리의 리포지토리(repo)로부터 새로운 세션 생성

명령어 (Commands)

명령어	설명
(default)	기존 세션에 자동 연결하거나 새로 생성
...

워크트리 설정 (Worktree Configuration)

리포지토리 루트에 ccmux.toml을 배치하여 워크트리 생성 후 명령어를 실행할 수 있습니다:

[worktree]
post_create = [
    "ln -s $CCMUX_REPO_ROOT/node_modules $CCMUX_INSTANCE_PATH/node_modules",
...

새로운 워크트리 내부에서 다음 환경 변수(environment variables)와 함께 실행되는 명령어:

변수	설명
CCMUX_REPO_ROOT	메인 리포지토리의 절대 경로
...

기여하기 (Contributing)

git clone git@github.com:TheHumbleTransistor/ccmux.git
cd ccmux
pip install -e ".[dev]"
...

PR(Pull Requests)을 환영합니다 — 큰 변경 사항의 경우 먼저 이슈(issue)를 생성해 주세요.

라이선스 (License)

MIT — LICENSE를 참조하세요.