tui-worktree

작업 트리 및 파일 탐색

연결된 모든 Git worktree를 목록으로 보여주고, 각 worktree의 변경된 파일을 탐색할 수 있습니다. 1, 2, 3 키로 worktree, 파일, diff 패널 간 포커스를 전환할 수 있으며, tab/shift+tab으로 worktree 간 이동이 가능합니다.

diff 검토 및 필터링

선택된 파일의 diff를 줄 번호, 구문 강조 표시, 자동 줄바꿈과 함께 보여줍니다. / 키로 경로별 파일 필터링이 가능하며, esc로 필터를 해제할 수 있습니다. w로 줄바꿈 토글, n으로 줄 번호 토글이 가능합니다.

편집기 연동 및 작업 수행

e 키로 선택된 파일을 $EDITOR에서 첫 번째 변경된 줄 근처에서 열 수 있습니다. Vim, VS Code, JetBrains 계열 등 주요 에디터는 줄 힌트를 지원합니다. p로 PR/MR 생성(gh 또는 glab 필요), m으로 worktree 브랜치 병합, d로 비보호 worktree 및 브랜치 삭제(확인 후)를 수행할 수 있습니다.

자동 새로고침 및 테마 지원

작업 트리 변경 사항을 5초마다 자동으로 새로고침하여 최신 상태를 유지합니다. t 키로 테마 선택기를 호출해 테마를 전환할 수 있으며, --transparent 플래그 또는 TUI 내 설정으로 터미널 배경을 그대로 사용할 수 있습니다. 테마 설정은 ~/.config/tui-worktree/config.json에 저장됩니다.

다운로드·설치 방법

Homebrew를 사용하는 경우 다음 명령으로 설치할 수 있습니다:

brew install overthinker1127/tap/tui-worktree

Go를 통한 설치는 다음과 같이 수행합니다:

go install github.com/overthinker1127/tui-worktree/cmd/tui-worktree@latest

Go로 설치한 후, $(go env GOPATH)/bin 또는 GOBIN 경로가 시스템 PATH에 포함되어 있어야 실행할 수 있습니다. Linux 사용자는 GitHub 릴리스에서 DEB, RPM, APK 패키지를 다운보아 각각의 패키지 관리자로 설치할 수 있습니다.

기본 사용법/명령어

현재 저장소의 worktree를 검토하려면 단순히 다음을 실행합니다:

tui-worktree

특정 저장소를 지정하려면 --repo 플래그를 사용합니다:

tui-worktree --repo /path/to/repo

특정 테마를 적용하려면:

tui-worktree --theme kanagawa-wave

터미널 배경을 사용하려면:

tui-worktree --transparent

도움말과 버전 정보를 확인하려면 각각 다음을 실행합니다:

tui-worktree --help

tui-worktree --version

이런 경우에 유용합니다

AI 코딩 도구(예: Superpower, Codex, Claude Code)가 생성한 변경 사항을 여러 worktree에 분산시켜 작업한 후, 이를 통합적으로 검토해야 하는 개발자에게 유용합니다. 작업 트리 간 이동과 파일 비교를 반복하는 대신, 하나의 인터페이스에서 변경 사항을 확인하고 병합 또는 삭제 결정을 내릴 수 있어 작업 효율을 높일 수 있습니다.

지원 환경·시스템 요구사항

이 도구는 Git이 설치된 시스템에서 실행되며, 터미널은 truecolor를 지원해야 합니다. Windows, macOS, Linux에서 사용 가능하며, Go 1.26.2 이상이 필요합니다. PR/MR 생성 기능을 사용하려면 GitHub CLI(gh) 또는 GitLab CLI(glab)가 별도로 설치되어 있어야 합니다.

최신 버전·업데이트

현재 최신 버전은 v1.0.4이며, 이 버전에서 Linux 패키지(DEB, RPM, APK) 지원과 Go 설치를 통한 최신 버전 설치 방법이 추가되었습니다. 구성 파일은 사용자 홈 디렉터리의 ~/.config/tui-worktree/config.json에 저장되어 테마 및 투명 배경 설정을 유지합니다.

제한 사항·확인 사항

이 도구는 터미널 기반 TUI이므로 그래픽 사용자 인터페이스(GUI)를 제공하지 않습니다. truecolor를 지원하지 않는 터미널에서는 색상이 정상적으로 표시되지 않을 수 있습니다. PR/MR 생성 기능은 gh 또는 glab가 설치되어 있어야만 사용할 수 있습니다.