PHPackages lightszentip/laravel-release-changelog-generator - 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. [Utility & Helpers](/categories/utility) 4. / 5. lightszentip/laravel-release-changelog-generator ActiveLibrary[Utility & Helpers](/categories/utility) lightszentip/laravel-release-changelog-generator ================================================ Package to create releases and changelogs in laravel 1.1.0(2mo ago)1116.6k↓36%6[1 issues](https://github.com/lightszentip/laravel-release-changelog-generator/issues)[3 PRs](https://github.com/lightszentip/laravel-release-changelog-generator/pulls)MITPHPPHP >=8.4CI passing Since Dec 22Pushed 1w agoCompare [ Source](https://github.com/lightszentip/laravel-release-changelog-generator)[ Packagist](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator)[ Docs](https://github.com/lightszentip/laravel-release-changelog-generator)[ RSS](/packages/lightszentip-laravel-release-changelog-generator/feed)WikiDiscussions main Synced 3d ago READMEChangelog (10)Dependencies (28)Versions (23)Used By (0) Package to create releases and changelogs in Laravel ==================================================== [](#package-to-create-releases-and-changelogs-in-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/17eafc7d029492530f621e4b3b2800cf3b5fc93cf62dfc3bf61876be45d1580a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator)[![Total Downloads](https://camo.githubusercontent.com/9597d075878d2e73183313f69de0600c0330fd688c8685df4a84c56a7bc19f90/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator)[![PHP-CS-Fixer](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/quality-check.yml/badge.svg?branch=main)](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/quality-check.yml)[![Update Changelog GIT](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/update-changelog-main.yml/badge.svg)](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/update-changelog-main.yml) This package adds changelog management over the command line and version release management. You can add new changelog items, and if you release, the changelog is updated with the new version and the version file. Thus, it is easy to manage a customer changelog. The changelog is a JSON file that can easily be integrated into a controller to present to the end customer. See [ROADMAP](ROADMAP.md) for new functions. *HINT*: Please run 'php artisan vendor:publish --tag=resources' Version Compatibility --------------------- [](#version-compatibility) Release Changelog GeneratorPHPLaravel0.1.x>=8.090.2.0>=8.090.2.1>=8.09 / 10 (not tested)0.3.x>=8.19 / 100.4.x>=8.2111.0.x>=8.311, 121.1.x>=8.412, 13Installation ------------ [](#installation) You can install the package via Composer: ``` composer require lightszentip/laravel-release-changelog-generator ``` Please publish the necessary files with: ``` php artisan vendor:publish --provider="Lightszentip\LaravelReleaseChangelogGenerator\ServiceProvider" php artisan vendor:publish --tag=resources ``` Usage ----- [](#usage) If the command is used without arguments, the command line creates an ask for all necessary arguments. ### Create a new changelog item: [](#create-a-new-changelog-item) ``` php artisan changelog:add --type="feat" --message="Implement the whole function for magic" php artisan changelog:add --type="fix" --message="Fix the magic" --issue="42" php artisan changelog:add --type="feat" --message="Module feature" --module="core" ``` Options: `--type`, `--message`, `--issue` (optional issue reference), `--module` (optional module name). You can find the result in resources/.changes/changelog.json ### Release the changelog [](#release-the-changelog) ``` php artisan changelog:release --releasename="My First Release" --type=patch ``` This updates the version.yml to the next patch version and add in the changelog.json a new release with all current changelog items. ### Set a specific release version: [](#set-a-specific-release-version) ``` php artisan changelog:set-release --releasename="My Release" --versionnumber="2.1.0" ``` ### Update the version without creating a release: [](#update-the-version-without-creating-a-release) ``` php artisan changelog:update-version --type=patch ``` Types: `patch`, `minor`, `major`, `rc`, `timestamp` ### Show the current version: [](#show-the-current-version) ``` php artisan changelog:show-version php artisan changelog:show-version --format=full ``` ### Update CHANGELOG.md file: [](#update-changelogmd-file) This will update the CHANGELOG.md file in the root with your changes. ``` php artisan changelog:generate-md ``` ### Get the version in the application [](#get-the-version-in-the-application) #### Blade [](#blade) ``` @releasechangelog ``` To get a special format for the version, you find in the 'releasechangelog.php' in the config dir the item ' version\_formats'. You can add new formats and/or change the existing ones. To use it: ``` @releasechangelog('full') ``` #### Code [](#code) ``` app('releasechangelog.version')->showVersion($format) ``` ### Config [](#config) `prerelease` set to false to remove the "rc" part from version To use another pre-release name as 'rc', change it on version.yml direct. ### Example Result [](#example-result) #### version.yml [](#versionyml) ``` label: v major: 1 minor: 0 patch: 1 prerelease: rc prereleasenumber: 0 buildmetadata: null timestamp: date: null timestamp: null ``` #### changelog.json [](#changelogjson) ``` {"unreleased":{"name":"tbd","date":"","release":false}, "1.0.1.rc0":{"name":"My First Release","date":"2022-12-22 23:56:34","release":true,"feat":[{"message":"My first feature"},{"message":"Implement the whole function for magic"}]}} ``` AI & Pipeline Integration ----------------------------- [](#ai--pipeline-integration) ### JSON Output Flag [](#json-output-flag) Every Artisan command supports `--json` for machine-readable output: ``` php artisan changelog:show-version --json # {"version":"1.0.0"} php artisan changelog:suggest-release --json # {"type":"minor","reason":"Feature type 'feat' found in unreleased entries"} TYPE=$(php artisan changelog:suggest-release --json | jq -r '.type') php artisan changelog:release --releasename="My Release" --type="$TYPE" ``` ### Read Commands [](#read-commands) ``` # List all released versions php artisan changelog:list php artisan changelog:list --json # Show unreleased entries (default) or a specific version php artisan changelog:show php artisan changelog:show --unreleased --json php artisan changelog:show --ver=1.0.0 --json ``` ### MCP Server (Claude Code / AI Tools) [](#mcp-server-claude-code--ai-tools) The package ships a standalone MCP server that AI tools (Claude, Cursor, etc.) can use to read and write the changelog without a full Laravel bootstrap. **Setup:** 1. Copy the example config to your project root: ``` cp vendor/lightszentip/laravel-release-changelog-generator/.mcp.json.example .mcp.json ``` 2. Adjust paths in `.mcp.json` if your project uses non-default locations: ``` { "mcpServers": { "changelog": { "command": "vendor/bin/changelog-mcp", "env": { "CHANGELOG_PATH": "resources/.changes/changelog.json", "VERSION_PATH": "resources/.version/version.yml" } } } } ``` **Available MCP Tools:** ToolDescription`add_entry`Add a changelog entry to unreleased (`type`, `message`, optional `module`/`issue`)`get_unreleased`Return the current unreleased section`get_version`Return the current version (optional `format` parameter)`list_releases`List all released versions`create_release`Bump version and create a new release (`name`, `type`: patch/minor/major/rc)Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Lightszentip](https://github.com/lightszentip) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 57 — FairBetter than 98% of packages Maintenance91 Actively maintained with recent releases Popularity35 Limited adoption so far Community15 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~122 days Recently: every ~173 days Total 11 Last Release 71d ago Major Versions 0.4.1 → 1.0.02025-09-02 PHP version history (6 changes)0.1.0PHP >=8.0|^8.1 0.3.0PHP >=8.1|^8.2 0.3.5PHP >=8.1|^8.2|^8.3 0.4.0PHP >=8.2|^8.3 1.0.0PHP >=8.3 1.1.0PHP >=8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/5d722951b53368586c9137845a403cb158950e9a0b325d67f470e34e11177aae?d=identicon)[lightszentip](/maintainers/lightszentip) --- Top Contributors [![lightszentip](https://avatars.githubusercontent.com/u/3680505?v=4)](https://github.com/lightszentip "lightszentip (200 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (180 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (177 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (51 commits)")[![robbanl](https://avatars.githubusercontent.com/u/922250?v=4)](https://github.com/robbanl "robbanl (5 commits)")[![iabduul7](https://avatars.githubusercontent.com/u/24309704?v=4)](https://github.com/iabduul7 "iabduul7 (1 commits)")[![xalunda](https://avatars.githubusercontent.com/u/2316221?v=4)](https://github.com/xalunda "xalunda (1 commits)") --- Tags ai-tools-developerartisan-commandchangelogdevelop-toolslaravellaravel-packagemcp-clientrelease-clilaravellightszentiplaravel-release-changelog-generator ### Code Quality TestsPest Static AnalysisPsalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/lightszentip-laravel-release-changelog-generator/health.svg) ``` [![Health](https://phpackages.com/badges/lightszentip-laravel-release-changelog-generator/health.svg)](https://phpackages.com/packages/lightszentip-laravel-release-changelog-generator) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k205.7M1.3k](/packages/laravel-sail)[statamic/cms The Statamic CMS Core Package 4.8k3.6M992](/packages/statamic-cms)[friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103519.9k53](/packages/friendsoftypo3-content-blocks)[rcsofttech/audit-trail-bundle Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking. 1189.8k](/packages/rcsofttech-audit-trail-bundle)[altis/local-server Local Server module for Altis 18221.6k3](/packages/altis-local-server)[ycodetech/valet-windows A more enjoyable local development experience for Windows. A Windows port of the popular Laravel Valet and a fork of cretueusebiu/valet-windows, with new features. 451.7k](/packages/ycodetech-valet-windows) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)