Release utils

Tiny npx commands to automate your git release flow — guess the next version, tag & branch a release, generate a changelog, and commit with a prompt.

Language-agnostic: bumps versions across Node, Rust, Python, Java/Maven, .NET, Ruby, Elixir, Gradle, PHP, Dart/Flutter, Helm, Deno, Ansible and more.

Built to avoid the bulk and complexity of tools like @auto-it or release-it.

Requires Node.js >= 20.

npx --package @sladg/release-utils utils help

Commands

guess — print the next version (to stdout) based on a commit message.

npx --package @sladg/release-utils utils guess "feat: add login" v1.2.3   # -> v1.3.0

shipit — bump the version across your manifest files, regenerate the lockfile, tag the commit, and push a release/ branch. Works across many ecosystems out of the box — Node, Rust, Python, Java/Maven, .NET, Ruby, Elixir, Gradle, PHP, Dart/Flutter, Helm, Deno, Ansible and more.

npx --package @sladg/release-utils utils shipit --changelog

changelog — write CHANGELOG.md, grouped by tag with GitHub/GitLab/Bitbucket links.

npx --package @sladg/release-utils utils changelog

commit — interactive commitizen prompt (emoji + conventional), no config needed.

git add . && npx --package @sladg/release-utils utils commit

More

Advanced flags, monorepo usage, and the full list of supported version files (package.json, Cargo.toml, pyproject.toml, pom.xml, *.csproj, *.gemspec, mix.exs, Chart.yaml, …) are in USAGE.md.