easy-worktree

name	easy-worktree
description	easy-worktree-rs リポジトリで `wt` コマンドを使って worktree を作成・切替・整理するための実践ガイドです。2 文字エイリアス、基本操作、主要オプション、よく使う運用フローをまとめています。

easy-worktree Skill

このスキルは、このリポジトリで Rust 版 wt コマンドを使うときの最小手順と運用パターンを提供します。

使う場面

• 「新しい作業ブランチを別ディレクトリで始めたい」
• 「今の変更を退避して別 worktree へ移したい」
• 「PR 番号から作業環境をすぐ作りたい」
• 「古い worktree を安全に掃除したい」
• 「bare リポジトリ運用で --git-dir を使いたい」
• 「2 文字エイリアスで短く操作したい」

クイックスタート

# 既存リポジトリを初期化
wt in

# feature ブランチ用 worktree を作成
wt ad feature-123

# 作成した worktree にジャンプ（サブシェル）
wt se feature-123

# 作業後は exit で戻る
exit

2 文字エイリアス

コマンド	エイリアス
clone	cn
init	in
add	ad
list	li, ls
diff	di, df
config	cf
rm / remove	rm
clean	cl
setup	su
stash	st
pr	pr
select	se, sl
current	cu, cur
checkout	co
run	ru
completion	cm
doctor	dr

主要コマンド

• wt init / wt in
  • 現在の Git リポジトリを easy-worktree 管理として初期化します。
• wt add [<name> [base_branch]] [--skip-setup|--no-setup] [--select [command...]] / wt ad ...
  • 新しい worktree を作成します。
  • <name> なしの場合は作業名を入力し、--select なしなら作成後に選択するかを Y/n で確認します。Enter の既定値は yes です。
• wt select [<name>|-] [command...] / wt se ... / wt sl ...
  • worktree に切り替えます。
  • 引数なしで fzf 選択、- で直前の worktree に戻ります。
• wt list [--pr] [--days N] [--merged] [--closed] [--all] [--sort ...] [--asc|--desc] / wt li ... / wt ls ...
  • worktree 一覧を表示します。
• wt stash <name> [base_branch] / wt st ...
  • 現在の変更を stash し、新規 worktree 側へ移します。
• wt rm [<name>] [-f|--force]
  • worktree を削除します。
  • <name> なしの場合は削除対象の worktree を対話選択します。
• wt clean [--days N] [--merged] [--closed] [--all] [--yes|-y] / wt cl ...
  • 条件に合う不要 worktree をまとめて削除します。
• wt pr add <number>
  • PR の head branch 名と同じ名前の worktree を作成します（gh 必須）。
• wt setup / wt su
  • 設定に従って .env などをコピーし、hook を実行します。
• wt diff [<name>] [args...] / wt di ... / wt df ...
  • 対象 worktree で diff を確認します。
• wt config [--global|--local] [key [value]] / wt cf ...
  • 設定の確認・更新を行います。優先順位は Global > Local > Project です。
  • 例: wt cf --global worktrees_dir ".my_global_worktrees"
• wt current / wt cu / wt cur
  • 現在の worktree 名を表示します。
• wt co <name> / wt checkout <name>
  • 対象 worktree のパスを表示します。
• wt run <name> <command...> / wt ru ...
  • 対象 worktree でコマンドを実行します。
• wt completion <bash|zsh> / wt cm ...
  • シェル補完スクリプトを出力します。
• wt doctor / wt dr
  • システム環境や依存ツール、設定ファイル（および無効キーの警告）を確認します。

よく使う運用フロー

1. 新規機能を並行開発する

wt ad feat/search-ui main --select

• main から feat/search-ui を切って、そのまま作業に入れます。

2. 今の変更を別作業として切り出す

wt st fix/login-bug
wt se fix/login-bug

• 現在の未コミット変更を新 worktree に移し、main 側を汚さず整理できます。

3. PR からレビュー/検証環境を作る

wt pr add 123
wt pr co 123

4. 古い worktree を掃除する

wt li --days 30
wt cl --merged

bare リポジトリでの使い方

--git-dir をグローバル引数として付けます。また、-C を使って特定のパスで実行することも可能です。

wt --git-dir=/path/to/sandbox.git in
wt --git-dir=/path/to/sandbox.git ad feat/abc main
wt -C /other/repo li

bare リポジトリでは、新しく追加される worktree は repo.git/ の内部ではなく、ベース worktree と同じ親ディレクトリ（例: repo/ 直下や repo/.worktrees/）に作成されます。

参照ドキュメント

• 全体仕様: README.md
• 日本語手順: README_ja.md
• 実装ベースのコマンド定義: src/lib.rs
• integration test: tests/integration.rs