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

show

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

Usage

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

Alias: sh

Arguments

ArgumentDescription
<target>Commit hash, branch name, or short ID

Git Options

Everything after a -- separator goes to git show untouched — see Passing Options to Git:

git loom show -- --stat
git loom show ab -- -U5
git loom show ab -- -- 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

git loom show ab
# Displays commit info and diff for the commit with short ID "ab"

Show a commit by hash

git loom show 9f484b6

Show a whole branch

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