vers repo tag create

Create a tag inside a repo that points to a specific commit. Tags are movable named pointers, think latest, v1.2.0, staging, known-good.

Synopsis

vers repo tag create <repo-name> <tag-name> <commit-id>
vers repo tag create <repo-name> <tag-name> <commit-id> --description "text"

Description

Creates a new tag inside the given repository pointing at the commit. The tag is unique per-repo; you can’t have two tags with the same name in the same repo (but my-app:latest and other-app:latest coexist fine). Tag names: 1-128 characters, letters, digits, hyphens, underscores, dots.

The commit must be owned by your org. You cannot tag another org’s commit, even if you can see it through a public repo. The way to “import” someone else’s commit is vers repo fork, which re-commits it under your ownership.

Options

Option	Description
`--description`, `-d`	Optional description of what this tag represents

Examples

Tag the result of a commit

vers commit
# ✓ Commit c7e4a2f1-… created

vers repo tag create my-app latest c7e4a2f1-…
# ✓ Tag created → my-app:latest

Tag with a description

vers repo tag create my-app known-good c7e4a2f1-… \
    -d "Last build that passed the integration suite"

Chain from a previous tag lookup

# Move a curated snapshot: look up one tag's commit, point another tag at it
COMMIT=$(vers repo tag get my-app staging --format json | jq -r .commit_id)
vers repo tag create my-app production "$COMMIT" -d "Promoted from staging"

Error Cases

Repository not found

vers repo tag create ghost latest c7e4…
# Error: repository not found

Commit not found or not yours

vers repo tag create my-app latest 00000000-…
# Error: commit not found
# or: forbidden   (if the commit exists but your org doesn't own it)

Solution for “forbidden”: you’re trying to tag someone else’s commit. Use vers repo fork instead.

Tag already exists

vers repo tag create my-app latest c9e4…
# Error: tag already exists in repository

Solution: use vers repo tag update to move the existing tag to a new commit, or delete it first with vers repo tag delete.

Invalid tag name

vers repo tag create my-app "my tag" c7e4…
# Error: Tag name can only contain alphanumeric characters, hyphens, underscores, and dots

Overview

Project Commands

Branch Commands

Repository Commands

VM Commands

Environment

Auth Commands

Utility Commands

Repo tag create

vers repo tag create

Synopsis

Description

Options

Examples

Tag the result of a commit

Tag with a description

Chain from a previous tag lookup

Error Cases

Repository not found

Commit not found or not yours

Tag already exists

Invalid tag name

See Also

​vers repo tag create

​Synopsis

​Description

​Options

​Examples

​Tag the result of a commit

​Tag with a description

​Chain from a previous tag lookup

​Error Cases

​Repository not found

​Commit not found or not yours

​Tag already exists

​Invalid tag name

​See Also

vers repo tag create

Synopsis

Description

Options

Examples

Tag the result of a commit

Tag with a description

Chain from a previous tag lookup

Error Cases

Repository not found

Commit not found or not yours

Tag already exists

Invalid tag name

See Also