Chlogr (Changelog Generator) is a fast, efficient, native CLI tool that automatically generates changelogs from GitHub tags, pull requests, and issues. Written in Zig with zero external dependencies, it produces clean Markdown changelogs categorized by type.
## Features
## Command-Line Options
--repo (required): GitHub repository in format [org]/[repo]. Example: github/cli--token (optional): GitHub API token. Falls back to env vars or gh CLI--output (optional): Output file path. Default: CHANGELOG.md--since-tag (optional): Start from this tag/version--until-tag (optional): End at this tag/version--exclude-labels (optional): Comma-separated labels to exclude--help or -h: Show help message## Authentication
The tool automatically retrieves a GitHub token in this order: 1) --token flag, 2) GITHUB_TOKEN env var, 3) GH_TOKEN env var, 4) gh auth token command. Required for private repos and recommended for higher rate limits.
## Usage Examples
Basic: chlogr --repo owner/repository With output: chlogr --repo owner/repository --output HISTORY.md With token: chlogr --repo owner/repository --token ghp_xxxxxxxxxxxx Tag range: chlogr --repo owner/repository --since-tag v1.0.0 --until-tag v2.0.0 Exclude labels: chlogr --repo owner/repository --exclude-labels duplicate,wontfix
## Technical Details
## Output Format
Generated changelogs include release/version headers with links, release dates, categorized entries (Features, Bug Fixes, Other), PR/issue numbers with links, contributor usernames with profile links, and clean Markdown formatting.
## Installation
Via snap: sudo snap install chlogr From source: git clone https://github.com/christianhelle/chlogr && cd chlogr && zig build
## Requirements
## Links
Source: https://github.com/christianhelle/chlogr Issues: https://github.com/christianhelle/chlogr/issues
You are about to open
Do you wish to proceed?
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
Snap can be installed from the command line on openSUSE Leap 15.x and Tumbleweed.
You need first add the snappy repository from the terminal. Choose the appropriate command depending on your installed openSUSE flavor.
Tumbleweed:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Tumbleweed snappy
Leap 15.x:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Leap_15.6 snappy
If needed, Swap out openSUSE_Leap_15. for, openSUSE_Leap_16.0 if you’re using a different version of openSUSE.
With the repository added, import its GPG key:
sudo zypper --gpg-auto-import-keys refresh
Finally, upgrade the package cache to include the new snappy repository:
sudo zypper dup --from snappy
Snap can now be installed with the following:
sudo zypper install snapd
You then need to either reboot, logout/login or source /etc/profile to have /snap/bin added to PATH.
Additionally, enable and start both the snapd and the snapd.apparmor services with the following commands:
sudo systemctl enable --now snapd
sudo systemctl enable --now snapd.apparmor
To install Changelog Generator, simply use the following command:
sudo snap install chlogr
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.