wtt 0.0.1

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

# 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 | Location |
|------|----------|
| Bare clones | `~/.wtt/bare/<repo>.git` |
| Worktrees | `~/devel/<repo>/<branch>/` |

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

## 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 `~/.wtt/bare/<repo>.git`
- Creates empty `~/devel/<repo>/` directory

### 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

### 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