Release with Confidence
Next-generation CLI tool that bridges the gap between raw code changes and professional releases. Now with interactive commit assistant, pre-flight summaries, and "status --json" for AI agents.
Intelligent Semantic
No more shell errors. Detects 'BREAKING CHANGE' in commit bodies automatically for Major bumps.
Guided Interactive CLI
Interactive commit assistant, pre-flight release summaries, and JSON output for AI agents. Every command guides you step by step.
Bilingual Intelligence
Auto-detects project language (EN/ES) and provides specialized technical help and tips.
NPM-ready Workflow
Run instantly with 'npx semver-ai-tool', or use the shorter 'semver-ai' command after a global install.
How it works
Commit your changes
Use 'semver-ai commit' for an interactive helper, or write feat:/fix: manually. Include 'BREAKING CHANGE:' in the body for major updates.
$git commit -m "feat: implement real-time collaboration"Run the magic
Launch the guided release flow with a single command: pre-flight summary, AI release notes, and auto-push.
$npx semver-ai-tool releaseInstallation
The SemVer AI Tool is designed with a zero-installation philosophy. Forget global packages; run it anywhere, anytime with npx.
Prerequisites
Node.js Ecosystem
Node.js 16+, NPM, and Git must be installed.
AI Intelligence
A Groq Cloud API Key is optional for AI-generated release notes.
Interactive Setup
Initialize in seconds.
$npx semver-ai-tool initUsage Guide
Lifecycle Stages
Initialize
Commit
Release
Live Simulator
Acciones
Automated Bump Logic
| Prefix | Bump Type | Category |
|---|---|---|
| feat: | Minor (0.1.0) | New Features |
| fix: | Patch (0.0.1) | Bug Fixes |
| BREAKING CHANGE: | Major (1.0.0) | API Breaking (In Body) |
Triggering a Release
Ready for the world?
$npx semver-ai-tool releaseCollaborative Workflow
Scale your versioning to work with multiple developers using standard Git flows and unified release management.
Team Commits
Members push features and fixes. Important: use 'BREAKING CHANGE:' in body for breaking API changes.
Merge to Main
Integrate PRs into the primary branch. The tool will aggregate all changes since the last tag.
Release Manager
A lead dev runs 'npx semver-ai-tool release' to consolidate work into a single, professional AI-documented version.
Architecture
A deep dive into the modular, secure, and high-performance core of SemVer AI Tool.
Layered System Design
CLI Router (src/cli.sh)
The shell-based entry point orchestrating command delegation and environment isolation.
Orchestration Layer (src/commands/)
Controllers like release.sh and init.sh that manage sequential logic and AI synthesis.
Core Services (src/core/)
The engine room: ai_client for LLM, git_manager for history, and version_logic.
Intelligence Module
Our ai_client.sh module constructs optimized prompts that combine your technical context with specialized documentation templates.
- Powered by Groq Cloud (LLaMA 3.3)
- Zero-latency intelligence
- Native Markdown synthesis
Conventional Commits
The standardized language for project history. Mastering this is key to unlocking SemVer AI's full potential.
The Base Format
Mandatory Types
Breaking Changes
No more "!" shell errors. Simply include "BREAKING CHANGE:" in your commit body.
feat(auth): migrate to oauth2 BREAKING CHANGE: keys from v1 are no longer valid as we transition to OAuth2.