Skip to main content

bump

Auto-bump version based on commit messages

Analyze commits since the last tag and bump the version accordingly.

Supported commit message formats:

+semver: markers (can appear anywhere in the commit message): +semver:major - Bump major version (1.0.0 -> 2.0.0) +semver:minor - Bump minor version (1.0.0 -> 1.1.0) +semver:patch - Bump patch version (1.0.0 -> 1.0.1) +semver:skip - Skip version bump entirely

Conventional Commits (https://conventionalcommits.org): feat: ... - Bump minor version fix: ... - Bump patch version feat!: ... - Bump major version (breaking change) BREAKING CHANGE: - Bump major version (in commit footer)

Conflict resolution:

  • Highest bump level wins (major > minor > patch)
  • +semver:skip takes precedence and prevents any bump

Examples:

versionator bump                   # Auto-bump and amend last commit
versionator bump --dry-run # Show what would happen
versionator bump --no-amend # Bump without amending the commit
versionator bump --mode=semver # Only use +semver: markers
versionator bump --mode=conventional # Only use conventional commits

Usage​

versionator bump [command] [flags]

Subcommands​

CommandDescription
majorIncrement major version (default), or use subcommands
minorIncrement minor version (default), or use subcommands
patchIncrement patch version (default), or use subcommands

major​

Increment major version (default), or use subcommands

Increment the major version. Use 'decrement' subcommand to decrement instead.

versionator bump major

minor​

Increment minor version (default), or use subcommands

Increment the minor version. Use 'decrement' subcommand to decrement instead.

versionator bump minor

patch​

Increment patch version (default), or use subcommands

Increment the patch version. Use 'decrement' subcommand to decrement instead.

versionator bump patch

Flags​

FlagTypeDefaultDescription
--dry-runboolfalseShow what would happen without making changes
--modestringallParse mode: semver, conventional, or all
--no-amendboolfalseUpdate VERSION file but do not amend the last commit