tag

See Git Basics - Tagging in the docs.

Create

Tag the current commit.

$ git tag v0.1.0

Tag with commit reference.

$ git tag v0.1.0 abcdef0

Add a message.

$ git tag v0.1.0 -m "Add foo to bar"

Delete

You’ll get an error if a tag exists.

$ git tag v0.1.0
fatal: tag 'v0.1.0' already exists

Delete.

$ git tag -d v0.1.0

Then create again.

List

With no args, list all tags.

$ git tag

The -l or --list flags alone add nothing here.

But that can be useful when finding a tag.

$ git tag -l -n v0.1.0
v0.1.0

Tag message

Add a message.

$ git tag v0.1.0 -m "Add foo to bar"

View it. This will show a given number of lines - using -n9 would show more lines of a tag.

$ git tag -n
v0.0.0     v0.0.0
v0.1.0     Add foo to bar

If you view tags on GitHub, you’ll see the message below the tag name.

Annotate

Sign the tag with annotation.

$ git tag v0.1.0 -a

Sort

Sort the tags by semantic convention and then reverse the order with most recent first.

$ git tag -n | sort -V -r

v0.5.0          Add docker support
v0.4.0          v0.4.0
v0.3.0          v0.3.0
v0.2.0          v0.2.0
v0.1.0          v0.1.0

Compare with:

$ git tag

v0.1.0
v0.2.0
v0.3.0
v0.4.0
v0.5.0