chlog

Tired of writing changelogs by hand? chlog reads your git commits and automatically generates a clean, organized changelog. Just run chlog in your project — no setup needed.

Install

cargo install --path .

Usage

chlog                          # print changelog
chlog -o CHANGELOG.md          # save to file
chlog --all                    # include all commit types
chlog --latest                 # latest version only
chlog --from v1.0 --to v2.0   # custom range

Commit Format

feat: add dark mode           → Features
fix: login crash              → Bug Fixes
perf: optimize queries        → Performance
docs: update readme           → Documentation
feat!: remove old API         → Breaking Changes
feat(auth): add OAuth         → Features (scoped)

Example Output

## v1.2.0 (2026-03-28)

### Features
- **auth:** add OAuth support (a3f2b1) (#12)

### Bug Fixes
- resolve login crash (b4e9c1)

## v1.1.0 (2026-03-15)

### Features
- add dark mode (c5d6e7)

Features

• Zero config — works out of the box
• Auto-detects versions from git tags
• Groups commits by type
• Links commit hashes and PR numbers to GitHub
• Supports scoped commits
• Filters out noise by default (--all to include everything)

License

MIT