mintlify-changelog 1.0.0

AI-powered, beautiful changelog generator for git repositories

Mintlify Changelog Generator 🚀

Generate beautiful, AI-powered changelogs directly from your git commits.

Features

✨ Smart Grouping - Intelligently groups related changes under clear categories
🔄 Enhanced Context - Uses repository data to provide richer context
🐛 Emoji Categories - Visually appealing headings with emoji indicators
📚 Auto Formatting - Proper markdown formatting ready for your docs site
🧠 AI-Powered - Leverages Claude AI for natural language understanding
🌐 Zero Config - Works immediately without complex setup

Installation

pip install mintlify-changelog

Or install directly from GitHub:

pip install git+https://github.com/mintlify/changelog.git

Quick Start

1. Navigate to any git repository
2. Set your API key (one-time setup):

   mintlify-changelog --set-api-key "your-api-key"
   

3. Generate a changelog:

   mintlify-changelog
   

Usage

mintlify-changelog [options]

Options

• -c, --count N - Generate changelog for the last N commits (default: 20)
• -o, --output FILE - Save changelog to a file (e.g., CHANGELOG.md)
• --title TITLE - Custom title for the changelog
• --dry-run - Preview the prompt without calling the API
• --set-api-key KEY - Set your Claude API key
• --version - Show version information
• -h, --help - Show help message

Examples

Generate for last 10 commits:

mintlify-changelog -c 10

Save to a file:

mintlify-changelog -o CHANGELOG.md

Custom title:

mintlify-changelog --title "Release v1.0.0"

Example Output

# My Project Changelog
### April 23, 2025

#### ✨ New Features
- Add user authentication system with OAuth support
- Implement dark mode across all components
- Add real-time notification system

#### 🐛 Bug Fixes
- Fix critical race condition in async data loading
- Address security vulnerability in input validation
- Resolve file upload issues on Safari browsers

#### 📚 Documentation
- Add comprehensive API documentation
- Create user onboarding guide with screenshots

---

This release introduces major new features including authentication, dark mode, and real-time notifications while addressing several critical bugs and improving documentation.

Environment Variables

• MINTLIFY_API_KEY - Your Claude API key
• MINTLIFY_BASE_URL - API base URL
• MINTLIFY_API_ENDPOINT - API endpoint path
• MINTLIFY_MODEL - Claude model to use
• MINTLIFY_MAX_TOKENS - Maximum tokens for API response
• MINTLIFY_TEMPERATURE - Temperature setting for API

Developing

Clone the repository and install in development mode:

git clone https://github.com/mintlify/changelog.git
cd changelog
pip install -e .

License

MIT