git-loom 0.18.0

A Git CLI tool that weaves together multiple feature branches into integration branches
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

# init

Initialize a new integration branch tracking a remote upstream. This is the entry point for starting a *git-loom* workflow.

## Usage

```
git loom init [name]
```

### Arguments

| Argument | Description |
|----------|-------------|
| `[name]` | Branch name (optional, defaults to `integration`) |

## What It Does

1. Creates a new local branch at the upstream tip
2. Configures upstream tracking (e.g. `origin/main`)
3. Switches HEAD to the new branch

All three happen in a single atomic operation.

### Upstream Detection

The upstream is resolved automatically in priority order:

1. **Current branch's upstream** — if you're on `main` tracking `origin/main`, the integration branch will also track `origin/main`
2. **Remote scan** — scans all remotes for branches named `main`, `master`, or `develop`
3. **Interactive prompt** — if multiple candidates are found, you're asked to choose
4. **Error** — if no remote tracking branches are found

## Examples

### Default

```bash
git loom init
# Initialized integration branch 'integration' tracking origin/main
```

### Custom name

```bash
git loom init my-integration
# Initialized integration branch 'my-integration' tracking origin/main
```

### Error: branch already exists

```bash
git loom init
# error: Branch 'integration' already exists
```

### Error: no remotes

```bash
git loom init
# error: No remote tracking branches found.
# Set up a remote with: git remote add origin <url>
```

## Prerequisites

- Must be in a git repository with a working tree
- At least one remote with a fetchable branch must be configured