gwt

git worktree 的
互動式切換指令

在終端機列出所有 worktree,用方向鍵選好,按 Enter 就切過去。

安裝

git clone https://github.com/doggy8088/git-worktree-tui.git
cd git-worktree-tui && bash install.sh
~/projects/shop zsh
> git worktree add ../shop-feature-tests -b feature/tests
Preparing worktree (new branch 'feature/tests')
 
> gwt
請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-5 直接跳轉, q/Esc 取消):

[1] …/shop[main](89ae97a)(目前位置)
[2] …/shop-feature-login[feature/login](89ae97a)
[3] …/shop-feature-search-api[feature/search-api](89ae97a)
[4] …/shop-fix-cart-bug[fix/cart-bug](89ae97a)
[5] …/shop-hotfix[detached](89ae97a)

 
> cd ~/projects/shop-feature-search-api
~/projects/shop-feature-search-api
> 

這是執行時的畫面:欄寬、光棒、分支顏色都和終端機裡一樣。

以前要在一堆路徑裡找一個目錄 先列出、再複製、貼到 cd 後面 gwt 把這四步收成一個 > 和一次 Enter。

先執行 gwt,看清單

在儲存庫或任何一個 worktree 裡執行,它會列出這個儲存庫的所有工作目錄。

~/projects/shop zsh

> gwt

請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-5 直接跳轉, q/Esc 取消):

用 ↑ ↓ 或 j k 直接操作這個選單,按 Enter 看看會發生什麼事。

40 個 worktree 時,選單只顯示終端機放得下的那一段

~/projects/shop zsh
> gwt --list | wc -l
40
請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-40 直接跳轉, q/Esc 取消):
[8] …/shop-feature-billing[feature/billing](4f21c9b)
[9] …/shop-feature-search[feature/search](4f21c9b)
[10] …/shop-fix-cart[fix/cart](4f21c9b)
[11] …/shop-fix-checkout[fix/checkout](4f21c9b)
[12] …/shop-hotfix[detached](4f21c9b)

顯示 8-16,共 40 筆

六個按鍵
就夠了

↑ ↓
上下移動,到頭尾會循環
不動
j k
跟 Vim 一樣的上下移動
不動
1 – 9
直接跳到該編號並切換
切換
Enter
切換到反白的 worktree
切換
q Esc
取消,維持原本的目錄
不動
Ctrl C
中斷,游標一定還回來
不動

清單比畫面高時只顯示一段視窗,選取項目會帶著視窗捲動,下方標示目前範圍。

它讀的是這份輸出

git worktree list --porcelain
worktree /Users/will/projects/shop
HEAD 89ae97a1b2c3d4e5f6
branch refs/heads/main

worktree /Users/will/projects/shop-feature
HEAD 89ae97a1b2c3d4e5f6
branch refs/heads/feature/search-api

worktree /Users/will/projects/shop-hotfix
HEAD 89ae97a1b2c3d4e5f6
detached

用 --porcelain 而不是給人看的對齊格式,路徑含空白也不會被切開。

小,而且驗過

每一個行為都有測試把關,包含在真的終端機裡送按鍵的互動測試。

25

個測試,其中 15 個是開著 PTY 送按鍵的互動測試

2

個平台跑 CI:Ubuntu 與 macOS

0

個執行期依賴,只需要 zsh 與 git

常見問題

會顯示一個符合終端機高度的視窗,選取項目帶著它捲動,下方標示目前範圍。原本清單超過畫面高度時,游標上移會被終端機夾住,整段區塊會飄走,這個問題在 0.1.0 之後修掉了。

顯示 8-16,共 40 筆

先裝起來
再回來看

兩行指令,之後在任何儲存庫裡打 gwt。

git clone https://github.com/doggy8088/git-worktree-tui.git && cd git-worktree-tui && bash install.sh