git-loom 0.25.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
69
70
71
72
73

# show

Show the diff and metadata for a commit, like `git show`.

## Usage

```
git loom show [<target>] [-- <git args>...]
```

Alias: `sh`

### Arguments

| Argument | Description |
|----------|-------------|
| `<target>` | Commit hash, branch name, or short ID |

### Git Options

Everything after a `--` separator goes to `git show` untouched — see [Passing Options to Git](README.md#passing-options-to-git):

```bash
git loom show -- --stat
git loom show osy -- -U5
git loom show osy -- -- src/main.rs
```

## What It Does

Displays the commit metadata (author, date, message) and diff for the resolved commit, exactly like `git show`. Uses git's native pager when running in a terminal.

- When given a **commit** (hash, partial hash, or short ID): shows that commit
- When given a **branch** (name or short ID): shows every commit the branch owns, newest first — the same commits `git loom status` lists under that branch, merge commits excluded. Naming a hidden branch shows it, even though `git loom status` leaves it out
- When given the **integration branch**: shows its loose commits, the ones `git loom status` puts on the integration line
- With **no target**: shows the commit at the top of `git loom status`

A branch that is not part of the integration stack — no upstream configured, a detached HEAD, or an unrelated history — falls back to plain `git show` behavior and displays only the branch tip. A branch that is part of the stack but owns no commits of its own is an error.

## Target Resolution

The target is resolved in this order:

1. **Branch names** — exact match resolves to the branch's commits
2. **Git references** — full/partial hashes, `HEAD`, etc. resolve to commits
3. **Short IDs** — branch short IDs resolve to the branch's commits, commit short IDs to commits

## Examples

### Show a commit by short ID

```bash
git loom show osy
# Displays commit info and diff for the commit with short ID "osy"
```

### Show a commit by hash

```bash
git loom show 9f484b6
```

### Show a whole branch

```bash
git loom show feature-a
# Shows every commit on feature-a, newest first
```

## Prerequisites

- Any git repository
- For short IDs, and to show a branch's full set of commits: must be on an integration branch with upstream tracking configured