gitpaper

The first ever generator of non-boring and actually detailed release notes

[!NOTE] The project is still under development and can already be used in some real-world cases, but the settings/principle of operation may change without notice before the first major version is released, so don't be upset if something breaks.

🛠️ Usage

npx gitpaper

gitpaper will automatically generate release notes starting from the last release to the last commit by default.

Here is an example of the generated Markdown:

   🚀 Enhancements

• Add support for terminal hyperlinks  -  by Dev Khalid (7e21c)

Now terminal links are clickable in supported environments, making logs and CLI output more interactive (and less copy-pasty).

   🐛 Fixes

• Resolve crash when reading empty config files  -  by Mei-Ling Zhou (c1d45)

Prevented an edge case crash when config files exist but contain... absolutely nothing. Now it fails gracefully and logs a warning.

The main feature is extended descriptions of changes in release notes, which makes it much clearer for your users

To have these descriptions appear in your release notes, you need to insert a special ::: changelog section in the extended commit description:

Multiline strings were inconsistently parsed when using backticks inside templates.

Tested on macOS, Ubuntu, and Windows 11 (PowerShell and Git Bash).

::: changelog
Enhanced the parser to correctly capture multiline strings, especially those using backticks.
No more chopped-off input on line breaks in the final output.
:::

Fixes #123

Co-authored-by: Chloe Nakamura <[email protected]>
Co-authored-by: Viktor Petrov <[email protected]>

So you decide what exactly should be written in the release notes.

❤️ Support

If you like this project, consider supporting it by starring ⭐ it on GitHub, sharing it with your friends, or buying me a coffee ☕

📜 License

MIT License © 2025-present Yurii Bogdan

👨‍🏭 Contributors

Thank you to everyone who helped with the project!