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.1

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.1
File	Size	Uploaded
release_tag-0.6.1.tar.gz	20.5 kB	Sep 16, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for release-tag 0.6.1
File	Interpreter	ABI	Platform	Reset
release_tag-0.6.1-py3-none-win_arm64.whl 243.7 kB Sep 16, 2026	Python 3	none	Windows ARM64	Details
release_tag-0.6.1-py3-none-win_amd64.whl 256.3 kB Sep 16, 2026	Python 3	none	Windows x86-64	Details
release_tag-0.6.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 353.7 kB Sep 16, 2026	Python 3	none	Linux glibc 2.17+ x86-64	Details
release_tag-0.6.1-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.1-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.1-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.1.tar.gz

Download URL	release_tag-0.6.1.tar.gz
Size	20.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`e3ada1e4c93b2889a4bc2e58f0af86f8cc2ed4d1ac933bdff0f43cd8f954213d`
BLAKE2b-256 checksum How to use checksums	`c2628a74de7d5a231df1c99061840cd065cd1957110871c33e65c1d3282a1ba8`
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.1-py3-none-win_arm64.whl

Download URL	release_tag-0.6.1-py3-none-win_arm64.whl
Size	243.7 kB
Tags	Python 3 Windows ARM64
SHA-256 checksum How to use checksums	`cf8c1649603382d084c193852e02b19474f53c8f9e8ef8406db6e29d21876251`
BLAKE2b-256 checksum How to use checksums	`12422233fb69c53ca43d428346461f447496bdbe978e2df797df533fab33042b`
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.1-py3-none-win_amd64.whl

Download URL	release_tag-0.6.1-py3-none-win_amd64.whl
Size	256.3 kB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`1b81a96695c90b1f8c9c27c59434c5ba54df201396a2fdfa0d64871069051115`
BLAKE2b-256 checksum How to use checksums	`dd4f2e2f9db12e8b151e02cd4e4c106aa5fc265bf8a9f8f7990080458cbad6a3`
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.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	release_tag-0.6.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	353.7 kB
Tags	Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum How to use checksums	`a7754177d2a616f7129efbf92942f9424b1da560a4b053b64f41159bd7fc0958`
BLAKE2b-256 checksum How to use checksums	`de44631bef29a6792ac3a00051bf842fab1029093374d991418e204d5a666b2f`
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.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	release_tag-0.6.1-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	`a3d5e082b8c2143027836f0e6d60c541532bfb9a7be300fdbbfbb4ecc9de78f8`
BLAKE2b-256 checksum How to use checksums	`d19f66fd756d5f1e239758efbf1038cf97d52ba5f3f07030910ff5924ca1e3b3`
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.1-py3-none-macosx_11_0_arm64.whl

Download URL	release_tag-0.6.1-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	`c9b286dc19a16d031d702d5a26ac9f9ffa926bf3f0e890adad589ff5a237f792`
BLAKE2b-256 checksum How to use checksums	`e0c2e51454c40c20c40b0b8ee05d1e3347a0e0e71a30a8036aa7e7f851268bec`
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.1-py3-none-macosx_10_12_x86_64.whl

Download URL	release_tag-0.6.1-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	`abc0857cd3a69ab69b0510b1512991f21ea4e2b1adf240e9c10f36b4936bfaf6`
BLAKE2b-256 checksum How to use checksums	`3e25004f4d6ab9f9d07dd7b9c9e074d9576773fe1deecb7297d8eb9582a4100a`
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}`