AI Changelog Generator
GraduatedAI-powered changelog generation that analyzes your actual code changes, not just commit messages.
Features
AI Code Analysis
Analyzes actual diffs and code changes, not just commit messages, for intelligent categorization
Multi-Provider Support
Works with OpenAI, Claude, Google, Azure, Bedrock, and local models like Ollama
Multiple Output Formats
Markdown, JSON, and customizable templates with conventional commits and emoji support
MCP Integration
Model Context Protocol server for Claude Desktop and other MCP-compatible tools
Quick Start
Get up and running in seconds. Works with any Git repository.
Install globally
npm install -g @entro314labs/ai-changelog-generatorOr use directly with npx
npx @entro314labs/ai-changelog-generator initGenerate your first changelog
ai-changelog --interactiveRequirements
- ✓Node.js >= 22.0.0
- ✓Git repository with history
- ✓API key for at least one AI provider
Common Commands
ai-changelogGenerate from recent commits
ai-changelog working-dirAnalyze working directory
ai-changelog --helpShow all options
Examples
Common Usage Patterns
Basic Usage
Generate changelog from recent commits
ai-changelog --since v1.0.0 --release-version 2.0.0Interactive Mode
Guided setup with provider selection
ai-changelog --interactiveWorking Directory
Analyze uncommitted changes
ai-changelog working-dir --dry-runCI/CD Integration
Generate changelog in automated pipeline
ai-changelog --since $LAST_TAG --release-version $NEW_VERSION --silentSample Output
# Changelog ## [2.0.0] - 2024-08-01 ### 🚀 Features - Add multi-provider AI support for changelog generation ([abc123](https://github.com/user/repo/commit/abc123)) - Implement MCP server for Claude Desktop integration ([def456](https://github.com/user/repo/commit/def456)) ### 🐛 Bug Fixes - Fix error handling for invalid Git repositories ([ghi789](https://github.com/user/repo/commit/ghi789)) ### ♻️ Refactoring - Restructure configuration system for better maintainability ([jkl012](https://github.com/user/repo/commit/jkl012))
Supported AI Providers
Works with 10+ AI providers. Use your preferred model or try multiple providers for different perspectives.
OpenAI
Anthropic Claude
Google AI
Azure OpenAI
AWS Bedrock
Ollama
Quick Setup
Environment Variables
OPENAI_API_KEY=your_keyANTHROPIC_API_KEY=your_keyGOOGLE_API_KEY=your_keyInteractive Configuration
ai-changelog providers configureChoose and configure your preferred provider