PHPackages phly/keep-a-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. [CLI & Console](/categories/cli) 4. / 5. phly/keep-a-changelog ActiveLibrary[CLI & Console](/categories/cli) phly/keep-a-changelog ===================== Tag and release packages on GitHub using Keep A Changelog; add new version entries to your changelog. 2.13.2(1y ago)183109.4k↓13.9%25[9 issues](https://github.com/phly/keep-a-changelog/issues)[5 PRs](https://github.com/phly/keep-a-changelog/pulls)20BSD-2-ClausePHPPHP ^8.1 Since Mar 27Pushed 1y ago4 watchersCompare [ Source](https://github.com/phly/keep-a-changelog)[ Packagist](https://packagist.org/packages/phly/keep-a-changelog)[ RSS](/packages/phly-keep-a-changelog/feed)WikiDiscussions 2.13.x Synced 1mo ago READMEChangelog (10)Dependencies (11)Versions (57)Used By (20) keep-a-changelog ================ [](#keep-a-changelog) [![Build Status](https://camo.githubusercontent.com/86c80af53e58736f8083e70759b4f824db3e22cbde77448017e2fc00bdf83c49/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f70686c792f6b6565702d612d6368616e67656c6f672e7376673f6272616e63683d6d6173746572)](https://secure.travis-ci.org/phly/keep-a-changelog)[![Coverage Status](https://camo.githubusercontent.com/2ed812b2ee621ea5e0d02765d8511264e44a07edff961dbd0785aba4dcd474fc/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f70686c792f6b6565702d612d6368616e67656c6f672f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/phly/keep-a-changelog?branch=master) This project provides tooling support for working with [Keep A Changelog](https://keepachangelog.com). Installation ------------ [](#installation) ### Local install via Composer [](#local-install-via-composer) Run the following to install this library: ``` $ composer require phly/keep-a-changelog ``` ### Global install via Composer [](#global-install-via-composer) Alternately, install globally, for use with any repository: ``` $ composer global require phly/keep-a-changelog ``` If you install globally, ensure you add global composer vendor binaries directory to your `$PATH` environment variable. You can get its location with following command: ``` $ composer global config bin-dir --absolute ``` You can add the following line to your shell profile to auto-add it to your PATH: ``` export PATH=$(composer global config bin-dir --absolute):$PATH ``` Once setup this way, you can call `keep-a-changelog` instead of `./vendor/bin/keep-a-changelog`. ### PHAR file [](#phar-file) Since version 2.3.0, we have offered standalone PHAR binaries. These are available under the downloads section for each release. To retrieve the latest, you can always use the following url: - Make the file executable (e.g., `chmod 755 keep-a-changelog.phar`), place it in your `$PATH`, and, optionally, remove the `.phar` suffix At the time of writing, the PHAR distribution is not yet capable of self-updating or checking for updates. Usage ----- [](#usage) Invocation will be via one of the following: - If you have installed via Composer within your project: `./vendor/bin/keep-a-changelog` - If you have installed globally via Composer, and have added the Composer script path to your `$PATH`: `keep-a-changelog`. - If you have downloaded the PHAR file and put it in your `$PATH`: either `keep-a-changelog.phar` or, if you removed the `.phar` file extension, `keep-a-changelog`. From here forward, we will use `keep-a-changelog` to invoke the command; substitute the appropriate command invocation based on your install. You may get a list of commands by running: ``` $ keep-a-changelog ``` From there, you can get help for individual commands using: ``` $ keep-a-changelog help ``` For more information, [please visit the documentation](https://phly.github.io/keep-a-changelog/#available-commands). ### Health Score 55 — FairBetter than 98% of packages Maintenance37 Infrequent updates — may be unmaintained Popularity49 Moderate usage in the ecosystem Community36 Small or concentrated contributor base Maturity86 Battle-tested with a long release history Bus Factor1 Top contributor holds 91.7% 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 ~49 days Recently: every ~202 days Total 50 Last Release 544d ago Major Versions 1.6.1 → 2.0.02019-06-04 PHP version history (4 changes)1.0.0PHP ^7.1 2.0.0PHP ^7.2 2.11.0PHP ^7.4 || ^8.0 2.13.0PHP ^8.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/25943?v=4)[Matthew Weier O'Phinney](/maintainers/weierophinney)[@weierophinney](https://github.com/weierophinney) --- Top Contributors [![weierophinney](https://avatars.githubusercontent.com/u/25943?v=4)](https://github.com/weierophinney "weierophinney (659 commits)")[![Lansoweb](https://avatars.githubusercontent.com/u/2109813?v=4)](https://github.com/Lansoweb "Lansoweb (15 commits)")[![michalbundyra](https://avatars.githubusercontent.com/u/7423207?v=4)](https://github.com/michalbundyra "michalbundyra (11 commits)")[![heiglandreas](https://avatars.githubusercontent.com/u/91998?v=4)](https://github.com/heiglandreas "heiglandreas (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![DASPRiD](https://avatars.githubusercontent.com/u/233300?v=4)](https://github.com/DASPRiD "DASPRiD (5 commits)")[![ramsey](https://avatars.githubusercontent.com/u/42941?v=4)](https://github.com/ramsey "ramsey (4 commits)")[![boesing](https://avatars.githubusercontent.com/u/2189546?v=4)](https://github.com/boesing "boesing (3 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (3 commits)")[![glensc](https://avatars.githubusercontent.com/u/199095?v=4)](https://github.com/glensc "glensc (1 commits)")[![noplanman](https://avatars.githubusercontent.com/u/9423417?v=4)](https://github.com/noplanman "noplanman (1 commits)")[![Xerkus](https://avatars.githubusercontent.com/u/725842?v=4)](https://github.com/Xerkus "Xerkus (1 commits)")[![fezfez](https://avatars.githubusercontent.com/u/1162307?v=4)](https://github.com/fezfez "fezfez (1 commits)")[![spawnia](https://avatars.githubusercontent.com/u/12158000?v=4)](https://github.com/spawnia "spawnia (1 commits)")[![c33s](https://avatars.githubusercontent.com/u/649209?v=4)](https://github.com/c33s "c33s (1 commits)")[![jcalonso](https://avatars.githubusercontent.com/u/664474?v=4)](https://github.com/jcalonso "jcalonso (1 commits)") --- Tags changelogclikeep-a-changelogphpkeepachangelog ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/phly-keep-a-changelog/health.svg) ``` [![Health](https://phpackages.com/badges/phly-keep-a-changelog/health.svg)](https://phpackages.com/packages/phly-keep-a-changelog) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[crunzphp/crunz Schedule your tasks right from the code. 2292.0M6](/packages/crunzphp-crunz)[povils/phpmnd A tool to detect Magic numbers in codebase 5795.6M193](/packages/povils-phpmnd)[illuminate/console The Illuminate Console package. 12944.1M5.1k](/packages/illuminate-console)[laminas/laminas-cli Command-line interface for Laminas projects 563.7M54](/packages/laminas-laminas-cli)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)