git-worktree-manager 0.0.1

CLI tool integrating git worktree with AI coding assistants
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

# git-worktree-manager (gw)

CLI tool integrating git worktree with AI coding assistants. Single static binary, instant startup.

Successor to [claude-worktree](https://github.com/DaveDev42/claude-worktree) (Python). Rewritten in Rust for single-binary distribution (~1.9MB) and ~3ms startup.

> **Backward compatible:** The `cw` command is included as an alias. Existing `cw` workflows, `.cwshare`, and `.cwconfig.json` files work unchanged.

## Install

```bash
# Homebrew
brew tap DaveDev42/tap
brew install git-worktree-manager

# Or download from Releases
# https://github.com/DaveDev42/git-worktree-manager/releases

# Or build from source
cargo install --path .
```

## Quick Start

```bash
gw new fix-auth          # Create worktree + launch AI tool
gw list                  # List worktrees
gw pr                    # Create GitHub PR
gw resume fix-auth       # Resume AI session
gw merge                 # Merge back to base
```

## Commands

| Command | Description |
|---------|-------------|
| `gw new <name>` | Create worktree + launch AI tool |
| `gw pr [branch]` | Create GitHub PR |
| `gw merge [branch]` | Rebase + merge + cleanup |
| `gw resume [branch]` | Resume AI session |
| `gw shell [branch]` | Open shell in worktree |
| `gw delete <target>` | Remove worktree |
| `gw list` | List all worktrees |
| `gw clean` | Batch cleanup (--merged, --older-than) |
| `gw status` | Show current worktree info |
| `gw tree` | Visual tree display |
| `gw stats` | Usage analytics |
| `gw diff <b1> <b2>` | Compare branches |
| `gw sync [branch]` | Rebase on base branch |
| `gw config ...` | Configuration management |
| `gw backup create/list/restore` | Git bundle backup |
| `gw stash save/list/apply` | Worktree-aware stash |
| `gw hook add/remove/list/...` | Lifecycle hooks |
| `gw export` / `gw import` | Config export/import |
| `gw doctor` | Health check |
| `gw scan` | Register repos for global mode |
| `gw -g <cmd>` | Global mode (cross-repo) |

## Shell Integration

```bash
# bash/zsh
source <(gw _shell-function bash)

# fish
gw _shell-function fish | source

# Or use interactive setup
gw shell-setup
```

This enables `gw-cd <branch>` for quick worktree navigation.

## Configuration

Config file: `~/.config/claude-worktree/config.json` (compatible with Python version).

```bash
gw config use-preset claude       # Default
gw config use-preset claude-yolo  # Skip permissions
gw config use-preset codex        # OpenAI Codex
gw config use-preset no-op        # No AI tool
```

## License

BSD-3-Clause