relnotes
An open-source changelog generation tool that reads commit records between two git refs and, using a local open-source LLM, rewrites them into grouped, user-readable release notes. It supports any OpenAI-compatible endpoint.
Timeline (last 90 days)
relnotes is an open-source CLI tool that reads the git log between two git refs and rewrites it into grouped, user-facing English changelog entries.
relnotes is open-sourced at github.com/Mystical89/relnotes under the MIT license, requires Python 3.10+, has no third-party dependencies, and comes with 5 passing tests.
relnotes is not tied to a specific model service but connects to any OpenAI-compatible endpoint, uses Ollama's qwen2.5:3b model by default, and can switch to LM Studio, llama.cpp or vLLM via a flag.
relnotes uses a strict system prompt to ensure rewrite quality: group by Added / Fixed / Changed, each entry no more than 12 words, no commit hashes, file names or jargon such as 'refactor' and 'chore' allowed, and uninformative commits are dropped outright.
relnotes sets the temperature to 0.3, so that running the same release twice yields essentially consistent output.
relnotes provides an offline fallback path: when no model is available (--offline), it generates the changelog based on Conventional Commits-driven grouping, with a structure consistent with the model output.
relnotes provides a Hermes skill that follows the Agent Skill Open Standard, allowing agents to invoke the CLI via natural language commands to generate release notes.
The author's positioning of relnotes is: it is not yet another changelog generator, but rather compresses the act of writing a changelog into a single command.
The author believes commit history should not leave the local machine, because commit messages leak internal project names, unreleased features, and occasionally keys that were mistakenly pasted in.
The relnotes project currently has no real users; this is day one of the project.
1 more timeline events
All Facts (11)
relnotes is an open-source CLI tool that reads the git log between two git refs and rewrites it into grouped, user-facing English changelog entries.
50%Unverifiedrelnotes is open-sourced at github.com/Mystical89/relnotes under the MIT license, requires Python 3.10+, has no third-party dependencies, and comes with 5 passing tests.
50%Unverifiedrelnotes is not tied to a specific model service but connects to any OpenAI-compatible endpoint, uses Ollama's qwen2.5:3b model by default, and can switch to LM Studio, llama.cpp or vLLM via a flag.
50%Unverifiedrelnotes uses a strict system prompt to ensure rewrite quality: group by Added / Fixed / Changed, each entry no more than 12 words, no commit hashes, file names or jargon such as 'refactor' and 'chore' allowed, and uninformative commits are dropped outright.
50%Unverifiedrelnotes sets the temperature to 0.3, so that running the same release twice yields essentially consistent output.
50%Unverifiedrelnotes provides an offline fallback path: when no model is available (--offline), it generates the changelog based on Conventional Commits-driven grouping, with a structure consistent with the model output.
50%Unverifiedrelnotes provides a Hermes skill that follows the Agent Skill Open Standard, allowing agents to invoke the CLI via natural language commands to generate release notes.
50%UnverifiedThe author's positioning of relnotes is: it is not yet another changelog generator, but rather compresses the act of writing a changelog into a single command.
50%UnverifiedThe author believes commit history should not leave the local machine, because commit messages leak internal project names, unreleased features, and occasionally keys that were mistakenly pasted in.
50%UnverifiedThe relnotes project currently has no real users; this is day one of the project.
50%UnverifiedThe relnotes repository structure includes relnotes.py (the CLI body), test_relnotes.py (tests), and the skills/relnotes/ directory (agent skills).
50%