NAME

repomatic git-tag - Create and push a Git tag

SYNOPSIS

repomatic git-tag [OPTIONS]

DESCRIPTION

Create and optionally push a Git tag.

This command is idempotent: if the tag already exists and --skip-existing is used, it exits successfully without making changes. This allows safe re-runs of workflows interrupted after tag creation.

OPTIONS

--tag TEXT: Tag name to create (e.g., v1.2.3).
[required]
--commit TEXT: Commit to tag. Defaults to HEAD.
--push / --no-push: Push the tag to remote after creation.
--skip-existing / --error-existing: Skip silently if tag exists, or fail with an error.
-o / --output FILE: Output file for created=true/false (e.g., $GITHUB_OUTPUT).
--help / -h: Show this message and exit.

ENVIRONMENT

GIT_TAG_TAG: Tag name to create (e.g., v1.2.3).
GIT_TAG_COMMIT: Commit to tag. Defaults to HEAD.
GIT_TAG_PUSH: Push the tag to remote after creation.
GIT_TAG_SKIP_EXISTING: Skip silently if tag exists, or fail with an error.
GIT_TAG_OUTPUT: Output file for created=true/false (e.g., $GITHUB_OUTPUT).
GIT_TAG__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

Create and push a tag

repomatic git\-tag \-\-tag v1.2.3

Tag a specific commit

repomatic git\-tag \-\-tag v1.2.3 \-\-commit abc123def

Create tag without pushing

repomatic git\-tag \-\-tag v1.2.3 \-\-no\-push

Fail if tag exists

repomatic git\-tag \-\-tag v1.2.3 \-\-error\-existing

Output result for GitHub Actions

repomatic git\-tag \-\-tag v1.2.3 \-\-output "$GITHUB_OUTPUT"

AUTHORS

Kevin Deldycke