SemVer AI Tool

English | Español

Automate semantic versioning and generate professional AI-powered release notes in seconds.

SemVer AI Tool is a next-generation CLI tool that bridges the gap between raw code changes and professional releases. It uses LLaMA 3.3 (via Groq API) to analyze your git history and explain the "why" and "what" behind your updates.

Features

• Interactive Commit Assistant — semver-ai commit guides you through type, scope, body, and breaking changes with a preview before committing.
• Guided Releases — semver-ai release shows a pre-flight summary (current version, bump type, commit count, AI mode) and asks for confirmation before proceeding.
• AI-Powered Release Notes — Uses LLaMA 3.3 to generate professional Markdown release notes from your git history.
• Interactive CLI — Every command suggests next steps. Never wonder "what now?"
• AI Agent Skill — The project ships as a hybrid CLI + AI skill. Run semver-ai skill install to make it available for AI coding assistants.
• JSON Output — semver-ai status --json outputs structured data for AI agents to consume.
• Bilingual — Fully localized in English and Spanish.
• Zero Install — Run instantly with npx semver-ai-tool.

Quick Start

# 1. Initialize your project
npx semver-ai-tool init

# 2. Make a conventional commit (interactive)
npx semver-ai-tool commit

# 3. Release with pre-flight summary
npx semver-ai-tool release

CLI Reference

| Command | Description | | :--- | :--- | | init | Interactive config wizard (creates .semver-ai.json + .semver-ai.env) | | release [patch\|minor\|major] | Full release: shows pre-flight summary, auto-detects bump, generates AI docs, commits and tags | | bump <patch\|minor\|major> | Manual version bump without AI analysis or docs | | commit | Interactive conventional commit assistant — guides through type, scope, body, breaking changes | | status [--json] | Show current version, last tag, pending bump, AI mode. --json for machine-readable output | | doctor | Diagnose configuration issues (Node, npm, Git, files, credentials) | | config [get\|set] | View or edit project configuration | | skill [install\|info] | Install or show the AI agent skill for this project | | guide <topic> | Interactive learning: semver, commits, workflow, ai, security, ci | | update | Check npm registry for newer version |

AI Integration

This project doubles as an AI agent skill. When loaded, an AI assistant can manage semantic versioning for your project without running the CLI directly.

# Install the skill for opencode/agent-based workflows
npx semver-ai-tool skill install

# Or export the skill spec
cat skills/semver-ai/SKILL.md

The skill at skills/semver-ai/SKILL.md describes the same logic the CLI implements — bump detection, version math, release notes generation, git operations, and security patterns.

Documentation

• Usage Guide: Deep dive into the tool integration.
• Technical Architecture: Explore the inner logic of the CLI.

👨‍💻 Author

Developed with ❤️ by Gonzalo S. A. Gómez on Sarit Startup.
Connect with me on LinkedIn.

Links

• LinkedIn Profile
• GitHub Repository
• Landing Page

License

MIT © Gonzalo Gomez