incrv

A command-line tool for managing version numbers in your package.json file. Supports semantic versioning with alpha and beta release management.

Installation

npm install -g incrv
# or
pnpm install -g incrv
# or
yarn global add incrv

Usage

Basic Version Management

incrv major    # Increment major version (1.2.3 → 2.0.0)
incrv minor    # Increment minor version (1.2.3 → 1.3.0)
incrv patch    # Increment patch version (1.2.3 → 1.2.4)

Release Management

The tool supports special handling for alpha and beta releases with automatic version numbering:

# Starting from 1.0.0
incrv release alpha   # → 1.0.0-alpha.0
incrv release alpha   # → 1.0.0-alpha.1  (increments alpha number)
incrv release beta    # → 1.0.0-beta.0   (switches to beta, resets number)
incrv release beta    # → 1.0.0-beta.1   (increments beta number)

For other release types, you can specify any custom release name:

incrv release rc      # → 1.0.0-rc
incrv release custom  # → 1.0.0-custom

Version Reset Rules

• When incrementing major version: resets minor, patch, and removes release tag
• When incrementing minor version: resets patch and removes release tag
• When incrementing patch version: removes release tag
• When switching between alpha and beta: resets the release number to 0

Examples

# Starting version: 1.2.3
incrv major          # → 2.0.0
incrv minor          # → 2.1.0
incrv patch          # → 2.1.1
incrv release alpha  # → 2.1.1-alpha.0
incrv release alpha  # → 2.1.1-alpha.1
incrv release beta   # → 2.1.1-beta.0

Development

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build the project
pnpm build

License

ISC