Usage Guide
Learn how to master the SemVer AI workflow and automate your project lifecycle.
The Standard Workflow
Initialize
Set up project config once
Commit
Use Conventional Commits
Release
Automated bump & notes
Commit Logic
| Prefix / Body | Bump | Description |
|---|---|---|
feat: | Minor | New features or enhancements. |
fix: | Patch | Bug fixes or small improvements. |
BREAKING CHANGE:or BREAKING-CHANGE: | Major | Include in the body of any commit to trigger a Major bump. No '!' needed. |
Creating a Release
When you're ready for a new version, the tool executes this sequence:
- •Scans git history (subject + body) from the latest tag
- •Calculates the highest priority bump (feat, fix, breaking)
- •Updates package.json version field
- •Synthesizes code diffs with AI (LLaMA 3.3)
- •Generates detailed Release Notes in Markdown
- •Creates a git commit and a version tag
- •Optional: Automatically push changes with --follow-tags
Utility Commands
npx semver-ai-tool commitInteractive conventional commit assistant: selects type, scope, body, and breaking changes with preview.
npx semver-ai-tool status --jsonShows current state as JSON for AI agents. Also accepts --json for machine-readable output.
npx semver-ai-tool doctorDiagnoses configuration issues: checks Node.js, npm, Git, config files, and credentials.
npx semver-ai-tool configViews or edits project configuration: config set release_language es.
npx semver-ai-tool bumpManual version bump without AI analysis: bump patch | minor | major.
npx semver-ai-tool guideInteractive learning: guide semver | commits | workflow | ai | security | ci.
npx semver-ai-tool skillInstall or show the AI agent skill. Run skill install to copy the skill to your opencode config.
npx semver-ai-tool updateChecks the npm registry for the latest version and shows update instructions if available.
Guided & Interactive
The entire CLI now guides you: commit walks you through conventional commits, release shows a pre-flight summary before proceeding, and status --json outputs structured data for AI agents.
Bilingual Intelligence
All commands automatically adapt to your project's primary language (EN/ES).