PHPackages churchtools/changelogger - 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. churchtools/changelogger ActiveLibrary[CLI & Console](/categories/cli) churchtools/changelogger ======================== CLI Tool for creating consistent and committable changelog entries. v0.8.2(1mo ago)3415.3k9[11 issues](https://github.com/churchtools/changelogger/issues)[4 PRs](https://github.com/churchtools/changelogger/pulls)1Apache-2.0PHPPHP ^8.2 Since Jul 31Pushed 3w ago6 watchersCompare [ Source](https://github.com/churchtools/changelogger)[ Packagist](https://packagist.org/packages/churchtools/changelogger)[ Docs](https://github.com/churchtools/changelogger)[ RSS](/packages/churchtools-changelogger/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (10)Versions (35)Used By (1) Changelogger ============ [](#changelogger) [![Changelogger Banner](./assets/banner.png)](./assets/banner.png) [![Total Downloads](https://camo.githubusercontent.com/3046b443fecb7a26a0fdc5ec3a9fd3141d43829161f3a91a6f54740284a3be0c/68747470733a2f2f706f7365722e707567782e6f72672f636875726368746f6f6c732f6368616e67656c6f676765722f642f746f74616c2e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/churchtools/changelogger) [![Latest Stable Version](https://camo.githubusercontent.com/c0e99c0e2b0e5ed43c4997b29ad209bc9e67e12202463c1a9fecde3ccfe9e29b/68747470733a2f2f706f7365722e707567782e6f72672f636875726368746f6f6c732f6368616e67656c6f676765722f762f737461626c652e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/churchtools/changelogger) [![License](https://camo.githubusercontent.com/35ec71e8b9f930a99214785edc1d0ba46e0240768aa2336c7a149a818ffe028b/68747470733a2f2f706f7365722e707567782e6f72672f636875726368746f6f6c732f6368616e67656c6f676765722f6c6963656e73652e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/churchtools/changelogger) [![Build Status](https://github.com/churchtools/changelogger/actions/workflows/php.yml/badge.svg)](https://github.com/churchtools/changelogger/actions/workflows/php.yml) **Changeloggger is a CLI tool to help you create better changelogs** At ChurchTools we develop a SaaS. To keep our users informed, we write changelogs for every version. We used to add our changelogs to the issue, but many times we forgot to add the changelog—and manual copy 'n' paste is tedious work! This tool helps us to write and create consistent changelogs that are committable so the reviewer can check it before merging. --- What does it do? ---------------- [](#what-does-it-do) *Changelogger* saves each log entry as a YAML file in `changelogs/unreleased`. During the development process many files from different features, bug fixes, and so on find their way into this folder. We create for each change a different file to easily track them. Adding them to a single file, like `Changelog.md` directly could lead to nasty merge conflicts. One file per change avoids that. In the end, if a new version is built, *Changelogger* takes all unreleased changes, sorts them and adds a new release to `CHANGELOG.md`. After that all files in `changelogs/unreleased` are deleted and your project is ready for the next version. **Changelogger is not taking your git-logs.** There exists many tools that take your git-log and converts commit messages to changelog entries. IMHO, this leads in many cases to bad changelogs. Commit messages are not changelogs. They are pieces of information for developers and not the users. Our changelogs are handcrafted because non-developers, AKA our users, should be able to understand the changes. Demo ---- [](#demo) [![Changelogger Demo](assets/changelogger-demo.gif)](assets/changelogger-demo.gif) Installation ------------ [](#installation) This package requires PHP 8.1 You can require the package as a dev-dependency ``` composer require --dev churchtools/changelogger ``` or install it globally. ``` composer global require churchtools/changelogger ``` Usage ----- [](#usage) ``` # To add a new changelog use `new`. changelogger new # When a new version is released run `release` to generate the changelog. # The is the version number or build number of the release. changelogger release # Need to start over? Run `clean` to remove all unreleased logs. changelogger clean ``` AI Agent Skills --------------- [](#ai-agent-skills) Changelogger ships with [Amp Skills](https://ampcode.com) that teach AI coding agents how to use Changelogger correctly. Copy the skill directories into your project to enable your AI agent to create changelog entries and releases automatically. ``` # Copy the skills into your project cp -r .agents/skills/using-changelogger /path/to/your-project/.agents/skills/ cp -r .agents/skills/releasing-with-changelogger /path/to/your-project/.agents/skills/ ``` SkillDescription`using-changelogger`Teaches the agent to create changelog entries with `changelogger new``releasing-with-changelogger`Teaches the agent to create releases with `changelogger release`License ------- [](#license) [churchtools/changelogger](https://github.com/churchtools/changelogger) is licensed under the [Apache License 2.0](LICENSE) ### Health Score 57 — FairBetter than 98% of packages Maintenance87 Actively maintained with recent releases Popularity34 Limited adoption so far Community23 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 86.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 ~206 days Recently: every ~404 days Total 13 Last Release 47d ago PHP version history (6 changes)v0.0.1PHP ^7.1.3 v0.5.0PHP ^7.2.5 v0.6.0PHP ^7.3 v0.7.0PHP ^7.4 || ^8.0 v0.8.0PHP ^8.1 v0.8.1PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/2bad241489c180589df98139823a92f1a84839196620090e089fdd51d67dc745?d=identicon)[obstschale](/maintainers/obstschale) ![](https://www.gravatar.com/avatar/5e9f38cf0d7f7b2143ae99c66e18ec928e8196d71b8b408dfb98f44763b5a3ed?d=identicon)[churchtools](/maintainers/churchtools) --- Top Contributors [![obstschale](https://avatars.githubusercontent.com/u/1058710?v=4)](https://github.com/obstschale "obstschale (137 commits)")[![djschilling](https://avatars.githubusercontent.com/u/3503166?v=4)](https://github.com/djschilling "djschilling (8 commits)")[![hettiger](https://avatars.githubusercontent.com/u/4583871?v=4)](https://github.com/hettiger "hettiger (6 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![cwandrey](https://avatars.githubusercontent.com/u/10060576?v=4)](https://github.com/cwandrey "cwandrey (1 commits)")[![ScottRudiger](https://avatars.githubusercontent.com/u/26824724?v=4)](https://github.com/ScottRudiger "ScottRudiger (1 commits)") --- Tags changelogchangeloggerchurchtoolsclikeepachangelogmarkdowncliconsolechangelogkeepachangelogchurchtools ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/churchtools-changelogger/health.svg) ``` [![Health](https://phpackages.com/badges/churchtools-changelogger/health.svg)](https://phpackages.com/packages/churchtools-changelogger) ``` ### Alternatives [symfony/console Eases the creation of beautiful and testable command line interfaces 9.8k1.1B13.9k](/packages/symfony-console)[nunomaduro/collision Cli error handling for console/command-line PHP applications. 4.7k357.7M11.1k](/packages/nunomaduro-collision)[nunomaduro/termwind It's like Tailwind CSS, but for the console. 2.5k271.5M387](/packages/nunomaduro-termwind)[wp-cli/php-cli-tools Console utilities for PHP 68227.8M374](/packages/wp-cli-php-cli-tools)[illuminate/console The Illuminate Console package. 13046.0M6.5k](/packages/illuminate-console)[tightenco/takeout Manage your dev dependencies with simple one-off Docker containers. 1.6k21.0k](/packages/tightenco-takeout) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)