Claude Code, Codex, OpenCode 같은 코딩 에이전트를 병렬 worktree에서 실행하고 조율하는 데스크톱·모바일·웹·CLI 앱입니다.
max-sixty/worktrunk
여러 AI 코딩 에이전트를 병렬로 실행할 수 있도록 브랜치 이름으로 git worktree를 관리하는 Rust CLI입니다.
- 스타
- 9,341
- 포크
- 333
- 열린 이슈
- 67
- 마지막 커밋
- 10시간 전
어떤 프로젝트인가요?
Worktrunk는 git worktree를 관리하는 명령줄 도구입니다. 경로와 원시 git 명령을 일일이 다루는 대신 브랜치 이름으로 각 worktree에 접근합니다. `wt switch`로 worktree 사이를 이동하고, `wt list`로 상태를 확인하며, `wt remove`로 브랜치와 함께 정리할 수 있습니다. 새 브랜치용 worktree는 명령 하나로 만들 수 있으며, 디렉터리 경로는 설정 가능한 템플릿을 바탕으로 계산됩니다.
이 프로젝트는 Claude Code나 Codex 같은 여러 AI 에이전트가 각자 별도의 worktree에서 서로 다른 작업을 동시에 수행해 변경 사항이 충돌하지 않도록 하는 워크플로를 염두에 두고 있습니다. worktree 생성이나 merge 같은 이벤트에 맞춰 hooks가 명령을 실행하고, 지원되는 파일시스템에서는 `wt step copy-ignored`로 `target/`이나 `node_modules/` 같은 빌드 캐시를 worktree 간에 공유할 수 있습니다. `wt switch pr:123`을 사용하면 pull request의 브랜치를 체크아웃합니다.
Worktrunk에는 정리 작업에 앞서 main 브랜치에 squash, rebase, fast-forward를 수행하는 로컬 merge 명령도 포함되어 있습니다. 또한 선택적으로 LLM이 커밋 메시지를 생성하며, `wt list --full`에서 CI 상태를 확인할 수 있습니다. Homebrew, Cargo, Winget, Arch Linux 패키지, conda-forge를 통해 설치할 수 있고, 명령으로 디렉터리를 변경할 수 있도록 셸 통합도 설정합니다.
핵심 기능
- 01브랜치 이름으로 worktree 전환, 생성, 목록 확인 및 제거
- 02명령 하나로 새 worktree에서 Claude 같은 AI 에이전트 실행
- 03worktree 디렉터리 경로 템플릿 설정
- 04생성, merge 전, merge 후 이벤트에 맞춰 명령을 실행하는 hooks
- 05APFS, btrfs, XFS에서 worktree 간 `target/`, `node_modules/` 같은 빌드 캐시 공유
- 06`wt switch pr:123`으로 pull request 브랜치 체크아웃
활용 사례
- 변경 사항이 서로 충돌하지 않도록 여러 AI 코딩 에이전트가 각자 다른 기능을 작업하게 하기
- 각각 다른 dev server 포트를 사용하는 여러 브랜치를 나란히 검토하고 테스트하기
- 완성된 기능 브랜치를 터미널에서 squash, rebase한 뒤 main에 merge하기
- 현재 작업을 방해하지 않고 팀원의 pull request를 별도 디렉터리에 체크아웃하기
빠른 시작
- 1
Homebrew로 설치하고 셸 통합을 설정합니다
brew install worktrunk && wt config shell install - 2
새 기능을 위한 worktree를 만듭니다
wt switch --create feature-auth - 3
모든 worktree를 상태와 함께 나열합니다
wt list
사용 전 알아둘 점
- 메타데이터에 라이선스가 NOASSERTION으로 표시되어 있으므로 사용하기 전에 저장소의 라이선스 조건을 확인하세요.
- 명령어로 디렉터리를 변경하려면 셸 통합이 필요하며, Windows에서는 기본적으로 다른 명령어 이름(git-wt)을 사용합니다.
토픽
자주 묻는 질문
- worktrunk은(는) 무엇인가요?
- 여러 AI 코딩 에이전트를 병렬로 실행할 수 있도록 브랜치 이름으로 git worktree를 관리하는 Rust CLI입니다. Worktrunk는 git worktree를 관리하는 명령줄 도구입니다. 경로와 원시 git 명령을 일일이 다루는 대신 브랜치 이름으로 각 worktree에 접근합니다. `wt switch`로 worktree 사이를 이동하고, `wt list`로 상태를 확인하며, `wt remove`로 브랜치와 함께 정리할 수 있습니다. 새 브랜치용 worktree는 명령 하나로 만들 수 있으며, 디렉터리 경로는 설정 가능한 템플릿을 바탕으로 계산됩니다.
- worktrunk은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- worktrunk은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- worktrunk은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. worktrunk의 마지막 커밋은 2026년 10월 21일입니다.
- worktrunk은(는) 어디에 사용할 수 있나요?
- 변경 사항이 서로 충돌하지 않도록 여러 AI 코딩 에이전트가 각자 다른 기능을 작업하게 하기 각각 다른 dev server 포트를 사용하는 여러 브랜치를 나란히 검토하고 테스트하기 완성된 기능 브랜치를 터미널에서 squash, rebase한 뒤 main에 merge하기 현재 작업을 방해하지 않고 팀원의 pull request를 별도 디렉터리에 체크아웃하기
- worktrunk는 어떻게 설치하나요?
- Homebrew로 설치하고 셸 통합을 설정합니다: brew install worktrunk && wt config shell install 새 기능을 위한 worktree를 만듭니다: wt switch --create feature-auth 모든 worktree를 상태와 함께 나열합니다: wt list
- worktrunk은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/max-sixty/worktrunk
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 코딩 에이전트의 계획과 코드 변경 사항을 브라우저에서 검토하고 피드백을 전달하는 로컬 도구입니다.
터미널에서 모델, Git 상태, 작업 공간, 컨텍스트 윈도우 사용량을 보여 주는 Rust 기반 경량 상태 표시줄입니다.
Claude Code나 Codex 에이전트 중 확인이 필요한 세션을 사이드바에 표시하도록 탭 바를 바꾼 macOS용 Warp 터미널 포크입니다.
여러 코딩 에이전트(Claude Code, Codex, Kimi Code, OpenCode 등)를 프로젝트, Git, 터미널과 함께 나란히 실행하는 가벼운 네이티브 데스크톱 작업 공간입니다.
AI가 생성한 작업 트리 변경 사항을 깔끔한 Conventional Commits, 브랜치, 안전한 pull·push와 GitHub PR로 정리하는 에이전트 스킬입니다.