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