Repolode
max-sixty

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. 1

    Homebrew로 설치하고 셸 통합을 설정합니다

    brew install worktrunk && wt config shell install
  2. 2

    새 기능을 위한 worktree를 만듭니다

    wt switch --create feature-auth
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트