tldr/pages/common/git-name-rev.md

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