Release notes, on autopilot
An open-source GitHub Action that turns merged PRs into persona-perfect notes, on your own runner and your own LLM key.
How it works
Four steps from merged PR to published release notes
Read the range
When you publish a release, the workflow finds the previous SemVer tag and collects the PRs and issues merged since.
release: published → previous SemVer tag → commits + PR numbers → PRs + linked issues
Classify smart
Your LLM provider (OpenAI, an OpenAI-compatible endpoint, or AWS Bedrock) groups changes into features, fixes, security, and breaking changes.
labels + title + body → LLM classifier (your key) → grouped by category → runs on your runner
Draft per persona
One set of notes for each persona, shaped by the tone and instructions in your repository's config.
Engineer | Internal | Customer → tone + format rules → validated markdown → notes.json + files
Publish in GitHub
The notes go into the GitHub Release, CHANGELOG.md, and the job summary. Re-runs never duplicate them.
GitHub Release body → CHANGELOG.md → job summary → idempotent re-runs
Everything you need to ship great release notes
From merged PRs to persona-perfect notes, inside your own GitHub workflow
Multi-Persona Generation
Three versions of every release, written for Engineers, Internal/CSM teams, and Customers. Add your own personas in .releaseray/config.yml.
Tag-to-Tag Release Ranges
Each release covers what merged since the previous SemVer tag. Notes are written with your own OpenAI, OpenAI-compatible, or AWS Bedrock key.
GitHub-Native Publishing
Notes land in the GitHub Release, CHANGELOG.md, and the job summary, with no duplicates on re-runs. Slack, Teams, and Intercom outputs are planned for v1.1.
Private by Design
The Action runs on your runner with your keys. Nothing goes anywhere but GitHub and your LLM provider, and internal notes stay off public surfaces by default.
Free and open source
No plans, no seats, no trial. Bring your own LLM key.
Open source
MIT-licensed. You pay only your LLM provider and, on private repositories, your GitHub Actions minutes.
$0
- Engineer, Internal and Customer personas
- Runs in your own GitHub Actions workflow
- Your own OpenAI, OpenAI-compatible or AWS Bedrock key
- GitHub Release, CHANGELOG.md and job summary outputs
- Configuration in .releaseray/config.yml
- Slack, Teams and Intercom planned for v1.1
- No limits on repositories or releases
- Community support on GitHub
Follow along to v1.0.0
Try the simulated demo now, and watch the repository for the first release.