@amamo/verso

The npm package for the Verso release CLI.

Supported targets

Node.js 22.18 or newer is required. Install Verso with your preferred package manager:

# npm
npm install --save-dev @amamo/verso
# pnpm
pnpm add --save-dev @amamo/verso
# Yarn
yarn add --dev @amamo/verso
# Bun
bun add --dev @amamo/verso

First release

The following examples show Verso's CLI syntax. Invoke the local executable through your package manager or an existing project task; the getting-started guide shows the exact command for each supported package manager.

verso doctor
verso --dry-run --version 1.4.0
verso --version 1.4.0 --yes

A single package can use built-in defaults. Verso includes the root package by default. A workspace whose root manifest should not share the released version needs an explicit package pattern:

[workspaces]
patterns = ["packages/*"]
include_root = false

Verso updates one shared version, optionally writes a changelog, creates a release commit and annotated tag, and atomically pushes the current upstream branch plus that exact tag. It does not publish packages or create GitHub Releases.

Read the full configuration, CLI reference, and release state model.

Troubleshooting

Could not find Verso platform binary means the installation is incomplete or the platform is not supported. Confirm that optional dependencies are enabled, check the table above, and reinstall @amamo/verso.

Failed to launch Verso binary means the installed executable could not start. Reinstall, retain the printed cause, and include the OS, CPU, Node.js version, package-manager version, and verso --tool-version output in a bug report.