wb 0.2.0

git-branch interface backed by git-worktree
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

# wb — git-branch interface backed by git-worktree

`wb` replaces the daily `git branch` / `git checkout` workflow with a worktree-based workflow. Instead of switching branches in a single working directory, each branch gets its own worktree directory.

## Bare-repo directory layout

```
~/projects/my-project/
  .bare/                    # bare git repo
  .git                      # file: "gitdir: ./.bare"
  main/                     # worktree for main
  feature--auth/            # worktree for feature/auth
```

## Install

### From crates.io

```sh
cargo install wb
```

### With Nix

```sh
# Run directly
nix run github:yusukeshib/wb

# Install to profile
nix profile install github:yusukeshib/wb

# Dev shell
nix develop github:yusukeshib/wb
```

### From source

```sh
git clone https://github.com/yusukeshib/wb.git
cd wb
cargo install --path .
```

## Shell integration

Add to your `.zshrc`:

```zsh
eval "$(wb init zsh)"
```

Also supports `bash` and `fish`.

This provides:
- A `wb()` shell function that handles `cd` into worktrees
- Tab completions
- `wb_current_branch` prompt helper

## Usage

### Clone a repo into bare-repo layout

```sh
wb init https://github.com/user/repo.git
```

### Convert an existing repo

```sh
cd my-project
wb init
```

### List branches

```sh
wb list                   # list local branches
```

### Create a branch (+ worktree, cd into it)

```sh
wb create feature-x              # creates branch + worktree, cd's into it
wb create feature-y main         # from a specific start-point
```

### Delete branches

```sh
wb delete feature-x              # safe delete (branch + worktree)
wb delete --force feature-x      # force delete
wb delete one two three          # delete multiple
```

### Rename / move

```sh
wb rename new-name old-name      # rename branch + move worktree
wb rename new-name               # rename current branch
```

### Copy

```sh
wb copy new-copy existing        # copy branch + create new worktree
wb copy new-copy                 # copy current branch
```

## Configuration

Set via `git config`:

| Key | Default | Description |
|-----|---------|-------------|
| `wb.worktreeDir` | parent of `.bare` | Base directory for worktrees |
| `wb.naming` | `flat` | Naming convention: `flat` (`/` → `--`), `nested` (`/` preserved), `prefixed` (`repo-branch`) |

## How it works

- All branch operations go through `git branch` for ref management
- Worktree operations go through `git worktree add/remove/move`
- Current branch is detected by matching `cwd` to worktree paths (not `HEAD`)
- The `__wb_cd:` protocol lets the binary signal the shell wrapper to `cd`