Skip to content

brel

Release-Please-style release automation for GitHub, GitLab, and Forgejo. One CLI computes your next version, updates your files, writes your changelog, and keeps a release PR ready to merge.

brel (better releases) turns your Conventional Commits into releases. It scans your git history to compute the next SemVer version, bumps version strings in your JSON/TOML files, generates a changelog with git-cliff or changelogen, and maintains a single managed release PR — merge it, and brel can tag the release automatically. brel init scaffolds the whole CI workflow for you.

Install in seconds

Homebrew, cargo, npx, shell installer, or prebuilt binaries for macOS, Linux, and Windows. Installation →

Works with your forge

First-class support for GitHub Actions, GitLab CI, and Forgejo Actions — same config, same workflow. Forge guides →

Releases you can review

Nothing ships until you merge the release PR. Version, changelog, and file changes are all visible in the diff. How brel works →

One small TOML file

Sensible defaults, strict validation, and a selector syntax that updates versions anywhere in your JSON and TOML files. Configuration →