git-cleaner 0.1.0

Bulk cleanup of git worktrees and merged branches across multiple repositories
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# git-cleaner

Bulk cleanup of git worktrees and merged branches across multiple repositories.

## Features

- **Worktree cleanup** — Detect and remove worktrees that are fully merged into main with no uncommitted changes
- **Branch cleanup** — Delete local branches that are fully merged into main/master
- **Safe by default** — Dry-run mode shows what would be deleted before executing
- **Multi-repo scan** — Scan an entire directory of git repositories at once

## Install

```bash
cargo install git-cleaner
```

## Usage

```bash
# Scan and report all cleanable items
git-cleaner scan ~/projects

# Worktree cleanup (dry-run)
git-cleaner worktrees ~/projects

# Worktree cleanup (execute)
git-cleaner worktrees ~/projects --execute

# Branch cleanup (dry-run)
git-cleaner branches ~/projects

# Branch cleanup (execute)
git-cleaner branches ~/projects --execute

# Clean both worktrees and branches
git-cleaner all ~/projects --execute
```

### Output example

```
Scanning 125 repositories in /home/user/projects

arch-lint
  [DELETE] arch-lint-ts (feature/tree-sitter)
  [KEEP] arch-lint-global-config (feature/global-config) — 1 unmerged commits, uncommitted changes
  4 merged branches: feat/no-silent-result-drop, feature/global-config-v2, ...

--- Summary ---
Worktrees: 57 total, 28 removable
Merged branches: 537
```

### Safety

- **Worktrees** are only removed when:
  - All commits are merged into main/master
  - No uncommitted changes exist
- **Branches** are only deleted when fully merged (`git branch -d` equivalent)
- `--execute` flag is required for any destructive action
- Interactive confirmation before execution

## License

MIT