changelog

changelog generates a structured changelog for a tagged release and attaches it to the release on your Forgejo instance. It reads the commits between two tags, groups them by Conventional Commit type, and can optionally rewrite entries with a local or remote language model.

What it does

• Works out the release range from the tags in your repository.
• Collects every commit between the start and end tags.
• Groups commits by type (feat, fix, refactor, and so on).
• Optionally rewrites entries into prose using Ollama or any OpenAI-compatible provider.
• Creates or updates the Forgejo release for the end tag with the generated notes.
• Optionally commits the changelog back into the repository.

Quickstart

- uses: https://vc.maxkaya.com/maxpeterkaya/changelog@latest
  with:
    server_url: https://vc.maxkaya.com
    repository: owner/repo
    token: ${{ secrets.PAT }}

This creates or updates the release for the newest tag with a grouped changelog. No other inputs are required.

Documentation

• Installation — add the action to a workflow, token requirements, other ways to run it.
• Inputs Reference — every input, its default, and what it does.
• Outputs and Commit Groups — workflow outputs and how commit types map to sections.
• Tag Ranges and Rollup — how the start and end tags are chosen.
• Writing Changelogs to the Repository — commit the changelog back to your repo.
• Styles and LLM Providers — prose styles and Ollama/OpenAI setup.
• Troubleshooting — common messages and fixes.