snippetbashTip

git name-rev — Describe a commit using existing ref names. More information: <https://git-scm.com/docs/git-name-rev

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

refcommandcommitgit name-revcliexistingdescribeusing

Problem

How to use the git name-rev command: Describe a commit using existing ref names. More information: <https://git-scm.com/docs/git-name-rev>.

Solution

git name-rev — Describe a commit using existing ref names. More information: <https://git-scm.com/docs/git-name-rev>.

Show the name for HEAD:

git name-rev HEAD

Show only the name:

git name-rev --name-only HEAD

Enumerate all matching ref names:

git name-rev --all

Use only tags to name the commit:

git name-rev --tags HEAD

Exit with a non-zero status code instead of printing undefined for unknown commits:

git name-rev --no-undefined {{commit-ish}}

Show names for multiple commits:

git name-rev HEAD~1 HEAD~2 main

Restrict names to branch refs:

git name-rev --refs refs/heads/ {{commit-ish}}

Read commit IDs from stdin:

echo "{{commit-ish}}" | git name-rev --annotate-stdin

Code Snippets

Show the name for `HEAD`

git name-rev HEAD

Show only the name

git name-rev --name-only HEAD

Enumerate all matching ref names

git name-rev --all

Use only tags to name the commit

git name-rev --tags HEAD

Exit with a non-zero status code instead of printing `undefined` for unknown commits

git name-rev --no-undefined {{commit-ish}}

Context

tldr-pages: common/git name-rev

Revisions (0)

No revisions yet.