Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

status

Show the branch-aware commit graph. This is the default command when running git-loom with no arguments.

Usage

git-loom [status] [-f]

Options

OptionDescription
-f, --filesShow files changed in each commit

Output

The status displays a branch-aware commit graph using UTF-8 box-drawing characters, showing commits grouped by feature branch:

╭─ [local changes]
│    M file.txt
│   A  new_file.rs
│
│╭─ [feature-b]
│●   d0472f9 Fix bug in feature B
│●   7a067a9 Start feature B
├╯
│
│╭─ [feature-a]
│●   2ee61e1 Add feature A
├╯
│
● ff1b247 (upstream) [origin/main] Initial commit

Sections

The graph is rendered top-to-bottom with these sections:

  1. Local changes — shown only if the working tree has modifications, new files, or deletions. Each file is listed with a 2-char XY status matching git status --short.

  2. Feature branches — each branch is rendered as a side branch with its name in brackets, followed by its commits, closed with ├╯.

  3. Loose commits — commits not belonging to any feature branch, shown on the main integration line.

  4. Upstream marker — the merge-base between HEAD and the upstream tracking branch.

Symbols

SymbolMeaning
╭─Start of a section
├─Start of a subsequent branch in a stack
│Integration line continuation
││Continuation between stacked branches
●A commit
├╯End of a side branch
⏫Upstream has new commits

Short IDs

Each branch, commit, and file in the output is assigned a short ID — a compact identifier you can use with other git-loom commands. What you see in the status is what you type.

Branch Topologies

Independent branches

Each feature branch forks from the integration line independently:

│╭─ [feature-b]
│●   d0472f9 Fix bug in feature B
├╯
│
│╭─ [feature-a]
│●   2ee61e1 Add feature A
├╯

Stacked branches

Feature-b is stacked on top of feature-a:

│╭─ [feature-b]
│●   4e046ab Second commit on feature-b
│●   0b85ca7 First commit on feature-b
││
│├─ [feature-a]
│●   caa87a9 Second commit on feature-a
│●   18faee8 First commit on feature-a
├╯

Co-located branches

Multiple branches pointing to the same commit:

│╭─ [feature-a-v2]
│├─ [feature-a]
│●   2ee61e1 Add feature A
├╯

Upstream ahead

When upstream has new commits beyond the common base:

●   abc1234 Fix typo
│
│●  [origin/main] ⏫ 3 new commits
├╯ 204e309 (common base) 2025-07-06 Merge pull request #10

Prerequisites

  • Must be on a local branch (not detached HEAD)
  • Branch must have an upstream tracking branch configured