PHPackages                             mogic/changelog-helper - 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 &amp; Console](/categories/cli)
4. /
5. mogic/changelog-helper

ActiveProject[CLI &amp; Console](/categories/cli)

mogic/changelog-helper
======================

A laravel zero application to maintain your CHANGELOG file based on keepachangelog.com

v1.2.4(7mo ago)013MITPHPPHP ^8.3.0CI passing

Since Dec 10Pushed 7mo ago4 watchersCompare

[ Source](https://github.com/mogic-le/changelog-helper)[ Packagist](https://packagist.org/packages/mogic/changelog-helper)[ Docs](https://www.mogic.com)[ RSS](/packages/mogic-changelog-helper/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (40)Used By (0)

Changelog-Helper
================

[](#changelog-helper)

Changelog-Helper is a set of commandline utilities for adding and releasing new CHANGELOG.md entries as defined by [keepachangelog.com](https://keepachangelog.com) definition.

It helps with the creation of correct entries, version numbers, tags and the table of contents.

 [![Static Analysis](https://github.com/mogic-le/changelog-helper/actions/workflows/static.yml/badge.svg)](https://github.com/mogic-le/changelog-helper/actions/workflows/static.yml) [![Tests](https://github.com/mogic-le/changelog-helper/actions/workflows/pest-tests.yml/badge.svg)](https://github.com/mogic-le/changelog-helper/actions/workflows/pest-tests.yml) [![Total Downloads](https://camo.githubusercontent.com/83d4b89cb199e01ae5e48cc344edcde1a398aa80f7c77997bb261dd977904283/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f6769632f6368616e67656c6f672d68656c7065722e737667)](https://packagist.org/packages/mogic/changelog-helper) [![Latest Stable Version](https://camo.githubusercontent.com/ae1760245011cc3e1ef625b5fd847eeca4b8c72c07e03049d42ffef473b0f23a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f6769632f6368616e67656c6f672d68656c7065722e7376673f6c6162656c3d737461626c65)](https://packagist.org/packages/mogic/changelog-helper)

---

Documentation
-------------

[](#documentation)

The helper is built on top of the [Laravel Zero](https://laravel-zero.com) components and uses git as an internal command.

### Install

[](#install)

Via Composer

```
composer global require mogic/changelog-helper

```

To get a link index in your CHANGELOG, you have to set a env variable. Add it in your .env or set it global:

```
CHANGELOG_UNRELEASED_LINK=https://github.com/mogic-le/changelog-helper/compare/develop...main

```

### Usage of commands

[](#usage-of-commands)

#### Add entry

[](#add-entry)

You can run a one-liner using the `add` command:

```
changelog-helper add [added,changed,deprecated,fixed,...] This is a new entry line

```

Or you can use the same command in a interactive mode:

```
changelog-helper add

```

#### Add entry based on commits

[](#add-entry-based-on-commits)

You can use the same command in a interactive mode:

```
changelog-helper add-commit

```

#### Add new release

[](#add-new-release)

The release command creates a new release, based on your optional unreleased changes.

Optional: it commits the CHANGELOG.md changes and creates a tag on top of the last commit.

You can use run a one-liner:

```
changelog-helper release [major|minor|patch] 1|0

```

Or you can use the same command in a interactive mode:

```
changelog-helper release

```

Or you can use the same command and add a release number:

```
changelog-helper release 3.2.1

```

### Environmet variables

[](#environmet-variables)

- CHANGELOG\_RELEASE\_MESSAGE

Build &amp; release new version
-------------------------------

[](#build--release-new-version)

To build a new release version, we have to create the build with the release tag to create after.

```
./changelog-helper app:build changelog-helper --build-version=1.x.x
git add ./builds/changelog-helper
./changelog-helper add added Added new release build
git add ./builds/changelog-helper
git add ./CHANGELOG.md
./changelog-helper release minor 1.x.x
git push && git git push --tags

```

Author
------

[](#author)

Changelog-Helper was created by [Stefan Berger](https://github.com/bergo) from [MOGIC](https://www.mogic.com).

License
-------

[](#license)

Changelog-Helper is an open-source software licensed under the MIT license.

Tests
-----

[](#tests)

run `./vendor/bin/pest`

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance62

Regular maintenance activity

Popularity5

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 96.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 ~8 days

Recently: every ~0 days

Total

38

Last Release

234d ago

Major Versions

v0.9.6 → v1.0.02025-01-21

PHP version history (2 changes)v0.1.0PHP ^8.2.0

v1.2.2PHP ^8.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/a1a2e6fe03f91204de2117430a748a12db2957eb113d4a50fc86d68d3c851e11?d=identicon)[cweiske](/maintainers/cweiske)

![](https://www.gravatar.com/avatar/df5d716c37972e4a4ad94855b739ed7a2843ff965fe9275089abd1f81455ce68?d=identicon)[bergo](/maintainers/bergo)

---

Top Contributors

[![bergo](https://avatars.githubusercontent.com/u/619785?v=4)](https://github.com/bergo "bergo (88 commits)")[![andrethiel-mogic](https://avatars.githubusercontent.com/u/57357028?v=4)](https://github.com/andrethiel-mogic "andrethiel-mogic (3 commits)")

---

Tags

cliconsolemogic

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/mogic-changelog-helper/health.svg)

```
[![Health](https://phpackages.com/badges/mogic-changelog-helper/health.svg)](https://phpackages.com/packages/mogic-changelog-helper)
```

###  Alternatives

[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B11.3k](/packages/symfony-console)[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind

It's like Tailwind CSS, but for the console.

2.5k239.8M286](/packages/nunomaduro-termwind)[wp-cli/php-cli-tools

Console utilities for PHP

68325.0M367](/packages/wp-cli-php-cli-tools)[php-school/cli-menu

A command line menu helper in PHP

2.0k1.1M27](/packages/php-school-cli-menu)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
