Tag Release

Automatically create semantic version git tags.

$ tag
Push tag 'v1.0.1' to origin? (y/N): y
Tag 'v1.0.1' created and pushed to origin.

Usage

By default, tag will increment the smallest digit following SemVer precedence. Incrementing a specific version is achieved by passing the respective flag: --major, --minor, --patch.

Tags can be automatically pushed to a remote repository by passing --push.

tag supports pre-release versions. Creating a pre-release tag is achieved by the using the --suffix flag. For example, --suffix="alpha" will create a tag like v1.0.0-alpha. If the previous tag was for a pre-release, that suffix is preferred. This behavior can be overridden by passing --patch or --suffix="". Only incrementing the trailing pre-release identifier is currently supported.

tag authoritatively discourages duplicate tags for a single commit.

For the most up-to-date options, run tag --help,

$ tag --help
Calculate the next semantic version tag

Usage: tag [OPTIONS] [COMMAND]

Commands:
  completion  Generate completion script
  help        Print this message or the help of the given subcommand(s)

Options:
      --major                increment the major version
      --minor                increment the minor version
      --patch                increment the patch version
      --push                 create and push the tag to remote
      --print-only           print the next tag and exit
      --check                validate that the tag at HEAD has its previous version as an ancestor
      --no-fetch             skip fetching tags from remote
      --allow-untagged       allow HEAD to be untagged when using --check
      --debug                enable debug logging
      --prefix <PREFIX>      set a prefix for the tag [default: ""]
      --suffix <SUFFIX>      set the pre-release suffix (e.g., rc, alpha, beta) [default: ""]
      --metadata <METADATA>  set the build metadata [default: ""]
      --remote <REMOTE>      remote repository to push tag to [default: origin]
  -v, --version              version for tag
  -h, --help                 Print help

Autocomplete

tag provides autocomplete for bash, fish, powershell and zsh shells. For example, to enable autocomplete for the bash shell,

tag completion bash | sudo tee /etc/bash_completion.d/tag > /dev/null

Note: bash completion requires the bash-completion package be installed.

For more information, see tag completion <shell> --help for your respective <shell>.

Install

AUR:

tag is available from the Arch User Repository.

yay -S release-tag

pip:

tag is available as a pypi package.

pip install release-tag

cargo:

cargo install --locked --git https://github.com/jmelahman/tag

github:

Prebuilt packages are available from Github Releases.

Pre-commit

In your .pre-commit-config.yaml,

default_install_hook_types:
  - pre-push
repos:
  - repo: https://github.com/jmelahman/tag
    rev: a069af54b5de5379d3581e3fc027395d1ad0a982  # frozen: v0.5.0
    hooks:
      - id: tag-check

By default, it only runs on the pre-push stage, so you may need to install the pre-push hook after staging your changes.

Metadata

Release files for release-tag 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for release-tag 0.6.0
File	Size	Uploaded
release_tag-0.6.0.tar.gz	20.5 kB	Sep 16, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for release-tag 0.6.0
File	Interpreter	ABI	Platform	Reset
release_tag-0.6.0-py3-none-win_arm64.whl 243.7 kB Sep 16, 2026	Python 3	none	Windows ARM64	Details
release_tag-0.6.0-py3-none-win_amd64.whl 256.4 kB Sep 16, 2026	Python 3	none	Windows x86-64	Details
release_tag-0.6.0-py3-none-manylinux_2_39_x86_64.whl 342.4 kB Sep 16, 2026	Python 3	none	Linux glibc 2.39+ x86-64	Details
release_tag-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 344.3 kB Sep 16, 2026	Python 3	none	Linux glibc 2.17+ ARM64	Details
release_tag-0.6.0-py3-none-macosx_11_0_arm64.whl 298.6 kB Sep 16, 2026	Python 3	none	macOS 11.0+ ARM64	Details
release_tag-0.6.0-py3-none-macosx_10_12_x86_64.whl 312.6 kB Sep 16, 2026	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 1.8 MB

Release files / release_tag-0.6.0.tar.gz

Download URL	release_tag-0.6.0.tar.gz
Size	20.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`e46bde406f67d133d2ec023a23f1a48900546f8a8316f3f7173709a54c1e8eab`
BLAKE2b-256 checksum How to use checksums	`f5c496feda68a99fd988febe21f23b0b614c524ddf45899ad7510e1917ccbd78`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-win_arm64.whl

Download URL	release_tag-0.6.0-py3-none-win_arm64.whl
Size	243.7 kB
Tags	Python 3 Windows ARM64
SHA-256 checksum How to use checksums	`097a75a53846d38e2319213005583c00e0f806eb42057a1bcf927b1fc4fbdecb`
BLAKE2b-256 checksum How to use checksums	`4e10f73f109df6686476132ba0377f2c1ee16dca9212810014b8ee022bff34af`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-win_amd64.whl

Download URL	release_tag-0.6.0-py3-none-win_amd64.whl
Size	256.4 kB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`3b0c17ffc7fcd5f799cf3e6b398e4f9ceda5e4d5b5c1051da6a1f86eb9459e25`
BLAKE2b-256 checksum How to use checksums	`52a26c6ae23bad0ef4fe67ddc438cfcaac0a50ce30ddbc27e92075f40b8f285f`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-manylinux_2_39_x86_64.whl

Download URL	release_tag-0.6.0-py3-none-manylinux_2_39_x86_64.whl
Size	342.4 kB
Tags	Linux glibc 2.39+ x86-64 Python 3
SHA-256 checksum How to use checksums	`20c6fdf553f3bd922891dc320d7d96b1eb6df17c0830b73693c7b5cf5e82e996`
BLAKE2b-256 checksum How to use checksums	`464803c797e097cc370358ae81265caf2d2eeb7c0355b3178803766316000f0f`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	release_tag-0.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	344.3 kB
Tags	Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum How to use checksums	`693d428b40255271f73d91411a6d8e18c375cb4a26a83ffcbf464665df705963`
BLAKE2b-256 checksum How to use checksums	`87e4240602e7c793721908e7c6dbc71eb675f84d96707619121c197ab70358ad`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-macosx_11_0_arm64.whl

Download URL	release_tag-0.6.0-py3-none-macosx_11_0_arm64.whl
Size	298.6 kB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`d090b386e18d31a0d3cb5c888a128752bc059fdc1acd428122575fbf43bb10d1`
BLAKE2b-256 checksum How to use checksums	`8cff406c1852d060e04f43f5bd9335ea582c01430c4a62bc8ac40f525b492625`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / release_tag-0.6.0-py3-none-macosx_10_12_x86_64.whl

Download URL	release_tag-0.6.0-py3-none-macosx_10_12_x86_64.whl
Size	312.6 kB
Tags	Python 3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`68a8368131c425896146bc50421220855ba25f2ff073de89be9868dc19e8d194`
BLAKE2b-256 checksum How to use checksums	`4e95ae33684efdfec81316a705d3f5129296a1421f71ae047b45ce8e9bf30cb3`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`