gren review
A free, open-source CLI for turning GitHub project activity into release notes and changelogs.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
gren is a free, open-source Node.js command-line tool for GitHub projects that want release notes built from their repository activity. It can draw on issues, commits, milestones, and pull requests, then create or update a GitHub release for selected tags. It also generates a CHANGELOG.md from existing releases or project data. That makes it a fit for solo developers and small teams whose release workflow centers on GitHub and who prefer a command-line tool over a hosted release interface.
Its feature set is focused on shaping release documentation rather than managing every step of a release. Labels can group issue entries, while templates customize release and changelog output. Filters let maintainers ignore selected tags, commits, issues, or labels. Draft and prerelease options support review or pre-release publication, and a custom API URL allows connection to GitHub Enterprise. GitHub is the listed integration and source platform; the tool requires a GitHub token with repository access. Projects using another source platform, or seeking automated version calculation or package publishing, should look elsewhere for those capabilities.
The pricing model is free, and gren is distributed as an npm package for self-hosted use. Its documentation is the listed support channel, so teams should be comfortable installing and operating a CLI and consulting docs when they need help. Choose gren when the core task is generating and maintaining GitHub release notes or changelogs with control over grouping and formatting. It is less suited to teams that need a broader release automation system, a graphical workflow, or built-in publishing and versioning functions.
gren pros and cons
- Where it wins
- Builds release notes from issues, commits, milestones, or pull requests
- Creates or updates GitHub releases and generates CHANGELOG.md files
- Templates, labels, filters, drafts, and prereleases give output control
- Where it doesn't
- Works with GitHub repositories rather than multiple source platforms
- Requires a GitHub token with repository access
- Does not list automated version calculation or package publishing
gren fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update