wtt 0.0.5

Git worktree manager using bare clones
Documentation 
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

# wtt - Work Tree Tool

## Overview

CLI tool for managing git worktrees using bare clones.

## Installation

From a repository checkout:

```sh
cargo install --path wtt
```

## Paths

| Type        | Default Location                       |
|-------------|----------------------------------------|
| Config      | `~/.config/wtt.toml`                   |
| Bare clones | `~/.local/share/wtt/bare/<repo>.git`   |
| Worktrees   | `~/devel/<repo>/<branch>/`             |

Branch names containing `/` become subdirectories (e.g., `feature/login` → `~/devel/myrepo/feature/login/`).

## Configuration

Configuration is loaded from `~/.config/wtt.toml` by default. All fields are optional.

```toml
bare_clone_dir = "/path/to/bare/clones"
worktree_dir = "/path/to/worktrees"
```

### CLI Flags

| Flag                    | Description                            |
|-------------------------|----------------------------------------|
| `--config-file <PATH>`  | Load configuration from specified file |
| `--no-config-file`      | Disable configuration file loading     |

## Commands

### setup

Create bare clone and prepare worktree directory.

```sh
wtt setup <REPO> <URL>
```

- `<REPO>` - Local name for the repository
- `<URL>` - Git remote URL to clone
- Clones bare repo to `~/.local/share/wtt/bare/<repo>.git`
- Creates empty `~/devel/<repo>/` directory

### teardown

Remove a repository completely (inverse of setup).

```sh
wtt teardown [OPTIONS] <REPO>
```

- `<REPO>` - Repository name to remove
- `--force` - Force removal of worktrees with uncommitted changes
- Removes all worktrees
- Removes bare clone at `~/.local/share/wtt/bare/<repo>.git`
- Removes worktree directory at `~/devel/<repo>/`

### add

Create a worktree.

```sh
wtt add [OPTIONS] <BRANCH>
```

- `<BRANCH>` - Branch name for the new worktree
- `--base <BASE>` - Base ref for new branches (default: remote default branch)
- `--repo <REPO>` - Repository name (default: auto-detected from current directory)
- Auto-detects existing vs new branch:
  - If branch exists (local/remote): checkout
  - If branch doesn't exist: create from base
- Configures upstream tracking to `origin/<branch>` via git config, so `git push`
  and `git pull` work without additional flags, even for new branches that don't
  exist on the remote yet

### list

List worktrees.

```sh
wtt list [OPTIONS]
```

- `--repo <REPO>` - Repository name (default: auto-detected, or list all if outside worktree)

### remove

Remove a worktree.

```sh
wtt remove [OPTIONS] <BRANCH>
```

- `<BRANCH>` - Branch name of the worktree to remove
- `--repo <REPO>` - Repository name (default: auto-detected from current directory)
- Deletes worktree directory only, does not delete the branch