Changelog Generator

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

- Fast compiled binary with zero external dependencies (pure Zig stdlib)
- Generates Markdown changelogs from GitHub data automatically
- Categorizes entries by labels: Features, Bug Fixes, and Other
- Links to pull requests, issues, and contributors
- Smart token resolution with automatic fallback chain
- Tag-based filtering (--since-tag and --until-tag)
- Label exclusion support (--exclude-labels)
- Customizable output filename and path
- Works with any public or private GitHub repository
- Integration tests verify core logic

## 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) GITHUBTOKEN env var, 3) GHTOKEN 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

- Built with Zig 0.15+ for native performance
- Zero external dependencies - Zig stdlib only
- Single portable executable
- Cross-platform (Linux, macOS, Windows)
- Modular architecture: CLI parsing, token resolution, GitHub API, changelog generation, markdown formatting

## 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

- GitHub account (for private repos or higher rate limits)
- GitHub API token (optional but recommended)
- Zig 0.15+ for building from source

## Links

Source: https://github.com/christianhelle/chlogr
Issues: https://github.com/christianhelle/chlogr/issues