zerv versions every build relative to the latest tag reachable from HEAD. A repository —
or branch — with no tags has no base version, so zerv stops instead of inventing 0.0.0.
Reproduce
Any commit in a repo that has no tags yet:
Fix
- Create the first tag:
git tag v0.1.0 && git push origin v0.1.0
- Seed the base version explicitly when tagging is not yours to do:
zerv flow --tag-version "v0.1.0"
- In CI, check out with full history: a shallow clone (
fetch-depth: 1) can cut the tags
off. zerv’s reusable workflow uses fetch-depth: 0 for exactly
this reason.
See the version CLI for every override that can stand in for VCS-detected
values. Not this error? Every fix lives on
zerv errors and troubleshooting. Last modified on August 25, 2026