Installation

The SemVer AI Tool is designed with a zero-installation philosophy. Forget global packages; run it anywhere, anytime.

Prerequisites

Environment

Node.js, NPM, and Git must be installed. The tool uses npx to run on-demand.

Intelligence

A Groq Cloud API Key is optional. Without it, the CLI runs in Local Mode.

Interactive Setup

Run the following command in your terminal to begin the interactive wizard:

npx semver-ai-tool init

The tool will ask for project details, author name, docs directory, preferred language, and whether you want AI integration.

Security First

Your API credentials are never sent to our servers. Public preferences (project name, author, language) are stored in .semver-ai.json, while your private API key is stored separately in .semver-ai.env. The initialization process automatically adds the credentials file to your .gitignore to prevent accidental exposure.

First Release

Once initialized, you can generate your first AI-powered release with:

npx semver-ai-tool release