Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vers.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
vers repo tag delete

Delete tags by name. The commits they pointed at are not deleted.

​
Synopsis

vers repo tag delete <repo-name> <tag-name>...

​
Description

Accepts one repo name followed by one or more tag names in that repo. Each tag is deleted independently; if one fails, the command keeps going and reports the first error on exit. Deleting a tag is a pointer removal only. If the commit it named is still referenced by a VM or another tag, it stays reachable. Otherwise it becomes orphaned (but not immediately reclaimed).

​
Examples

​
Delete a single tag

vers repo tag delete my-app staging
# ✓ Tag 'staging' deleted from 'my-app'

​
Delete several

vers repo tag delete my-app v1.0 v1.1 v1.2
# ✓ Tag 'v1.0' deleted from 'my-app'
# ✓ Tag 'v1.1' deleted from 'my-app'
# ✓ Tag 'v1.2' deleted from 'my-app'

​
Delete all tags in a repo (but keep the repo)

vers repo tag delete my-app $(vers repo tag list my-app -q)

​
Error Cases

​
Repository or tag not found

vers repo tag delete my-app ghost
# ✗ Failed to delete tag 'ghost': Repository or tag not found
The command continues with any remaining tag names and returns the first error at the end.

​
See Also