A beautiful, modern CLI for generating intelligent changelogs from Git repositories
-
🎨 Beautiful UI - Modern terminal interface with colors, gradients, and stylish boxes
-
📋 Clipboard Support - Generated changelogs are automatically copied to your clipboard
-
📅 Flexible Date Ranges - Choose from preset ranges or select custom dates with a date picker
-
🖼️ Image Display - Show repository logos or any image directly in your terminal
-
💾 Save to File - Save generated changelogs to local files and open them afterward
-
🔄 Multiple Formats - Generate internal, external, or Mintlify-compatible changelogs
-
🤖 AI-powered - Uses Greptile AI to generate intelligent, context-aware changelogs
# Clone the repository
git clone https://github.com/greptileai/chameleon.git
cd chameleon
# Install dependencies
npm install
# Run setup wizard
npm run setup
You'll need the following API tokens:
-
GitHub Token - For accessing GitHub repositories (create one here)
-
Greptile API Key - For AI-powered changelog generation (get it here)
The setup wizard will guide you through obtaining and configuring these tokens.
# Display help
npm start -- --help
# Generate a changelog
npm start -- cl
After building and installing globally:
# Display help
chameleon --help
# Generate a changelog
chameleon cl
cl, changelog- Generate a changelog for a repository
Chameleon offers a fully interactive experience:
-
Repository Selection - Automatically detects current repo or enter any GitHub repo
-
Date Range - Choose from preset ranges or select custom dates with an interactive calendar
-
Format Selection - Pick from different changelog formats or create a custom one
-
Clipboard Integration - Results are automatically copied to your clipboard
-
File Export - Save to file with your preferred filename
-
Terminal Images - View repository logos or custom images right in your terminal
Choose from multiple formatting options:
-
Internal - Technical details targeting developers and internal teams
-
External - User-friendly changes suitable for customer-facing release notes
-
Mintlify - Special format compatible with Mintlify documentation
-
Custom - Provide your own custom instructions for tailored results
# Run in development mode
npm run start
# Build the project
npm run build
# Watch for changes
npm run build:watch
# Run tests
npm run test
This project is licensed under the MIT License - see the LICENSE file for details.
-
Built with cli-typescript-starter
-
Powered by Greptile for intelligent changelog generation
Made with ❤️ by Greptile