https://github.com/nozomiishii/git-harvest
🌾 Glorious Git Harvest
https://github.com/nozomiishii/git-harvest
branch cleanup cli git worktree
Last synced: 21 days ago
JSON representation
🌾 Glorious Git Harvest
- Host: GitHub
- URL: https://github.com/nozomiishii/git-harvest
- Owner: nozomiishii
- License: mit
- Created: 2026-03-26T13:05:00.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-02T08:19:55.000Z (25 days ago)
- Last Synced: 2026-04-03T02:23:50.481Z (24 days ago)
- Topics: branch, cleanup, cli, git, worktree
- Language: TypeScript
- Homepage:
- Size: 107 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.ja.md
- Changelog: CHANGELOG.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# git-harvest
[English](./README.md) | 日本語
merge 済み branch と worktree を自動で整理するツール
## インストールせずに直接実行
```sh
# bun
bunx git-harvest@latest
# pnpm
pnpx git-harvest@latest
# npm
npx -y git-harvest@latest
```
## インストール
### Shell (macOS/Linux) (recommended)
```sh
curl -fsSL https://raw.githubusercontent.com/nozomiishii/git-harvest/main/install.sh | bash
```
ターミナルを再起動するか `source ~/.zshrc` を実行すると git-harvest が使えるようになります。
### Homebrew
```sh
brew install nozomiishii/tap/git-harvest
```
### (任意) エイリアスを設定
エイリアスを設定するとより手軽に実行できます。両方設定しても片方だけでも設定できます:
`ghv` / `ghv!`
```sh
# シェルエイリアス
echo "alias ghv='git-harvest'" >> ~/.zshrc
echo "alias 'ghv!'='git-harvest --all'" >> ~/.zshrc
```
`git harvest`
```sh
# Git サブコマンド — `git harvest` で実行可能
git config --global alias.harvest '!git-harvest'
```
## アンインストール
```sh
curl -fsSL https://raw.githubusercontent.com/nozomiishii/git-harvest/main/uninstall.sh | bash
```
## 使い方
```sh
git-harvest
```
### オプション
```sh
git-harvest --help # ヘルプを表示
git-harvest --version # バージョンを表示
git-harvest --dry-run # 実際には削除せず、削除対象を表示
git-harvest --all # デフォルトブランチ以外の全ブランチ・worktree を削除
```
### `--all` モード
マージ状態に関係なく、デフォルトブランチとメインワーキングツリー以外の全リソースを削除します。
| リソース | 通常 | `--all` |
|---|---|---|
| メインワーキングツリー | 残る | 残る |
| デフォルトブランチ | 残る | 残る |
| マージ済み worktree / ブランチ | 削除 | 削除 |
| 未マージ worktree / ブランチ | 残る (GROWING) | 削除 |
| 未コミット変更のある worktree | 残る (GROWING) | 削除 |
| チェックアウト中の非デフォルトブランチ | 残る (GROWING) | エラー終了 |
- デフォルトブランチ以外をチェックアウト中に `--all` を実行すると、何も削除せずエラー終了します。
- `--dry-run --all` ではチェックアウト中のブランチも含め全リソースを `[WILL DELETE]` で表示します（エラーにならない）。
## おすすめの運用法
Git hooksのpost-mergeコマンドと合わせることで、Mergeやpullした際に自動で収穫もできます。
### [lefthook](https://github.com/evilmartians/lefthook)との連携
Git Hooks にはhusky、pre-commit、simple-git-hooks など様々なツールがありますが、Lefthook が言語に依存せず monorepo にも組み込みやすいのでおすすめです。さらに lefthook-local.yaml を使えば、チーム開発で他のメンバーに影響を与えず自分だけ実行する運用も可能です。
```yaml
# lefthook-local.yaml
post-merge:
commands:
git-harvest:
run: npx -y git-harvest@latest
# or: bunx git-harvest@latest
# or: pnpx git-harvest@latest
```
## 動作内容
1. `origin/HEAD` からデフォルトブランチ（main/master）を検出
2. デフォルトブランチにマージ済みのローカルブランチを特定（squash merge 含む）
3. マージ済みブランチに紐づく worktree を削除
4. マージ済みブランチを削除
5. リモートで削除済みの追跡ブランチを整理（`git fetch --prune`）
### ステータス表示
git-harvest は全ての worktree・ブランチの状態を表示します。
#### Worktree
| 状態 | 表示 | 説明 | 挙動 |
|---|---|---|---|
| マージ済み + 変更なし | `[DELETED]` / `[WILL DELETE]` | 収穫対象 | 削除 |
| マージ済み + 未コミット変更あり | `[GROWING] (uncommitted changes)` | 未保存の作業があるためスキップ | 残す |
| 未マージ | `[GROWING] (not merged)` | まだマージされていない | 残す |
| 独自コミットなし | `[GROWING] (no unique commits)` | 作成直後でまだ作業が始まっていない | 残す |
| メインワーキングツリー | *(表示なし)* | 常に除外 | 残す |
| デフォルトブランチ | *(表示なし)* | 常に除外 | 残す |
#### ブランチ
| 状態 | 表示 | 説明 | 挙動 |
|---|---|---|---|
| マージ済み + 削除可能 | `[DELETED]` / `[WILL DELETE]` | 収穫対象 | 削除 |
| マージ済み + チェックアウト中 | `[GROWING] (currently checked out)` | 現在使用中のためスキップ | 残す |
| 未マージ | `[GROWING] (not merged)` | まだマージされていない | 残す |
| 独自コミットなし | `[DELETED]` / `[WILL DELETE]` | worktree がなければ残骸ブランチとして削除 | 削除 |
| デフォルトブランチ | *(表示なし)* | 常に除外 | 残す |
### マージ検出方法
以下の手段を順に試み、いずれかで検出されたブランチをマージ済みと判定します:
1. **first-parent 一致** — ブランチ HEAD がデフォルトブランチの first-parent 上にある（独自コミットなし）
2. **ancestor チェック** — `git merge-base --is-ancestor` による通常マージ検出
3. **仮想 squash + git cherry** — `git commit-tree` で仮想 squash コミットを作成し、`git cherry` で比較
4. **cherry-pick フォールバック** — `git log --cherry-pick` による patch-id ベースの全コミット比較（履歴書き換え後の orphaned ブランチにも対応）