Installation

Get Versu set up in your project with one of the following methods.

NPM Installation

The easiest way to install Versu is via npm:

npm install -D @versu/cli

Or if you want to use it globally:

npm install -g @versu/cli

Yarn Installation

If you're using Yarn, install with:

yarn add --dev @versu/cli

Or globally:

yarn global add @versu/cli

PNPM Installation

For PNPM users:

pnpm add -D @versu/cli

Or globally:

pnpm add -g @versu/cli

Via GitHub Action

If you want to use Versu in your CI/CD pipeline, add this to your GitHub Actions workflow:

- uses: versuhq/versu@v3
  with:
    # Your configuration here

See the GitHub Action documentation for more details.

Verify Installation

After installation, verify Versu is working:

# If installed locally
npx @versu/cli --version

# If installed globally
versu --version

You should see the version number displayed.

System Requirements

• Node.js: 24 or higher
• Git: 2.0.0 or higher (for commit analysis)

Next Steps

Now that Versu is installed, check out:

• Quick Start - Run your first versioning cycle
• Configuration - Set up Versu for your project

Troubleshooting

Installation Fails

If you encounter issues during installation:

1. Clear your npm cache: npm cache clean --force
2. Delete node_modules and lock files
3. Reinstall: npm install

Version Command Not Found

If versu --version doesn't work:

1. Ensure Node.js is installed: node --version
2. Try using npx: npx @versu/cli --version
3. For global install, check your npm path: npm config get prefix

Getting Help

If you need help:

• Check the FAQ
• Open an issue on GitHub
• Read the API documentation