PHPackages amjitk/laravel-ai-changelog - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. amjitk/laravel-ai-changelog ActiveLaravel-package amjitk/laravel-ai-changelog =========================== AI-powered changelog generator for Laravel. v1.1.1(7mo ago)148MITPHPPHP ^8.2 Since Sep 30Pushed 7mo agoCompare [ Source](https://github.com/Amjitk/laravel-ai-changelog)[ Packagist](https://packagist.org/packages/amjitk/laravel-ai-changelog)[ RSS](/packages/amjitk-laravel-ai-changelog/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (4)Versions (6)Used By (0) 🤖 Amjithk/Laravel AI Changelog Generator ======================================== [](#-amjithklaravel-ai-changelog-generator) [](https://www.google.com/search?q=https://packagist.org/packages/amjithk/laravel-ai-changelog)[](https://www.google.com/search?q=https://packagist.org/packages/amjithk/laravel-ai-changelog)[](LICENSE.md) **Stop writing release notes manually!** This Laravel package automatically reads your Git commit history and uses the Gemini LLM via the [hosseinhezami/laravel-gemini](https://packagist.org/packages/hosseinhezami/laravel-gemini) package to generate concise, categorized, and user-friendly changelog entries, placing them directly at the top of your `CHANGELOG.md` file. ✨ Features ---------- [](#-features) - **AI-Powered Summarization:** Turns technical commit messages and diffs into human-readable release notes. - **Intelligent Categorization:** Automatically groups changes into sections like **✨ Features**, **🐛 Fixes**, and **🚀 Improvements**. - **Flexible Ranging:** Generate logs based on a commit SHA, a specific tag (e.g., `v1.0.0`), or by comparing a feature branch against a base branch (e.g., `staging`). - **Workflow Ready:** Designed to be run on feature branches, staging branches, or directly in your CI/CD pipeline. - **Non-Destructive:** Prepends new content to your existing `CHANGELOG.md`. --- 📥 Installation -------------- [](#-installation) You can install the package via Composer: ``` composer require amjithk/laravel-ai-changelog --dev ``` ### Configuration [](#configuration) Publish the configuration file using the Artisan command: ``` php artisan vendor:publish --tag=ai-changelog-config ``` This will create a `config/ai-changelog.php` file, allowing you to customize API settings, prompts, and default branches. ### Environment Setup [](#environment-setup) The package requires an API key for the Large Language Model you choose to use. Add your key to your `.env` file: ``` GEMINI_API_KEY="AIzaSyYourGeminiApiKeyHere" ``` --- 🚀 Usage ------- [](#-usage) The package provides a single powerful Artisan command: `changelog:ai:generate`. ### Basic Usage: Generating from a Tag [](#basic-usage-generating-from-a-tag) This is the most common use case for a release. It generates changes between the specified tag (`v1.0.0`) and the current commit (`HEAD`). ``` # Generate changelog for all changes since the v1.0.0 tag php artisan changelog:ai:generate --from=v1.0.0 --version=v1.1.0 ``` ### Workflow 1: Feature Branch Review [](#workflow-1-feature-branch-review) To generate the changelog for a feature branch (e.g., `feature/login`) by comparing it against your stable branch (`staging` is the default): ``` # While on your feature/login branch: php artisan changelog:ai:generate --version="New Login Flow" ``` The package automatically finds the common ancestor between your current branch and `staging` to isolate only your feature's changes. ### Workflow 2: Explicit Comparison [](#workflow-2-explicit-comparison) If you want to compare against a different branch or need to specify the comparison base: ``` # Compare current branch against 'develop' php artisan changelog:ai:generate --compare=develop --version="Feature Merge" # Compare between two arbitrary SHAs (e.g., in a CI pipeline) php artisan changelog:ai:generate --from=abc1234 --version="CI Build 5" ``` ### Command Options [](#command-options) OptionDescriptionDefault`--from`The starting Git commit SHA or tag. (e.g., `v1.0.0`)Calculated (last tag or merge-base)`--compare`The base branch to compare against when `--from` is omitted.`staging` (from config)`--version`Manually set the version/heading for the changelog entry.`UNRELEASED``--branch`The specific branch to analyze (defaults to current branch).Current Git Branch--- 🔧 Customization --------------- [](#-customization) You can fine-tune the AI's behavior by editing the published `config/ai-changelog.php` file. Config KeyPurpose`api.key`The AI API Key.`api.model`The specific LLM model to use (e.g., `gpt-4o-mini`, `gemini-2.5-flash`).`api.url`The API endpoint URL (for switching providers).`ai_prompt_prefix`**Crucial:** Customize the prompt to change the tone, language, or required output structure of the changelog.`output.file`Change the output file path (e.g., `RELEASES.md`).### Example: Changing the AI Model [](#example-changing-the-ai-model) To use Google's Gemini model, you would update the config file and your `.env`: **`.env`:** ``` GEMINI_API_KEY="AIzaSyYourGeminiApiKeyHere" ``` **`config/ai-changelog.php`:** ``` 'api' => [ 'model' => 'gemini-2.5-flash', // ... ], ``` --- 🤝 Contributing -------------- [](#-contributing) We welcome contributions! If you have suggestions for new features, better Git parsing, or improved AI prompts, please submit a Pull Request. ### Development Steps [](#development-steps) 1. Fork the repository. 2. Create your feature branch (`git checkout -b feature/awesome-feature`). 3. Commit your changes (`git commit -am 'Feat: Add awesome feature'`). 4. Push to the branch (`git push origin feature/awesome-feature`). 5. Create a new Pull Request. 📄 License --------- [](#-license) The Laravel AI Changelog Generator is open-sourced software licensed under the **[MIT license](LICENSE.md)**. ### Health Score 35 — LowBetter than 79% of packages Maintenance63 Regular maintenance activity Popularity9 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 5 Last Release 224d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/62fc496d0b4499c581e121467b6840dc741bd692abc6256373ae0d7c9377c9d7?d=identicon)[amjitk](/maintainers/amjitk) --- Top Contributors [![Amjitk](https://avatars.githubusercontent.com/u/96902489?v=4)](https://github.com/Amjitk "Amjitk (7 commits)") ### Embed Badge ![Health badge](/badges/amjitk-laravel-ai-changelog/health.svg) ``` [![Health](https://phpackages.com/badges/amjitk-laravel-ai-changelog/health.svg)](https://phpackages.com/packages/amjitk-laravel-ai-changelog) ``` ### Alternatives [laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M259](/packages/laravel-dusk)[laravel/boost Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code. 3.4k10.6M274](/packages/laravel-boost)[spatie/laravel-health Monitor the health of a Laravel application 85810.0M83](/packages/spatie-laravel-health)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[laravel-zero/framework The Laravel Zero Framework. 3371.4M369](/packages/laravel-zero-framework)[laravel-notification-channels/discord Laravel notification driver for Discord. 2371.3M11](/packages/laravel-notification-channels-discord) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)