What it does is simple:

• Collect commits and PRs from the previous release to the current release


• Categorize changes into sections such as Added, Changed, Fixed, Docs, and Chore
  


• Add a new release section to CHANGELOG.md
  


• Create a Pull Request with that change

If you configure an AI provider, it can use OpenAI, Anthropic, or Gemini to generate a more readable changelog section.

On the other hand, it also works with a fallback mode when no API key is provided.

So it is totally fine even if you do not use AI.

In other words, this is not:

A tool that can do nothing without AI.

It is more like:

An automation tool that works better with AI.

That is the key idea.

🐾 What was available up to v0.1

Up to v0.1, I focused on building the foundation of changelog-bot.

It already supported:

• CLI and GitHub Action usage


• Changelog generation from Git history


• Importing GitHub Release Notes


• OpenAI and Anthropic providers


• Heuristic fallback


• Dry-run mode

At this point, the basic experience was already there:

Automatically update CHANGELOG.md during a release workflow.

I also introduced it in this earlier article:

Now changelog-bot supports these three providers:

• OpenAI


• Anthropic


• Gemini

You can specify Gemini from the CLI like this:

changelog-bot \

  --provider gemini \

  --release-tag HEAD \

  --release-name 0.2.0 \

  --dry-run

You can also use it from GitHub Actions:

with:

  provider: gemini

env:

  GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}

I also added dry-run diagnostics.

Provider: gemini

Model: gemini-3.5-flash

AI used: true

Fallback reasons: none

This makes it easier to check whether the AI provider was actually used, or whether changelog-bot fell back to the heuristic mode.

It is a small feature, but I think this kind of observability is very important for CI tools.

When something runs in CI, you want to quickly understand what actually happened.

🚀 v0.3: Changelog customization

In v0.3, I added customization support for changelog generation.

is a tool for automating that process with Git history, Pull Requests, GitHub Release Notes, and AI.

In v0.2, I added Gemini support.

In v0.3, I added customization through language, instructions, and instructions file.

With these changes, changelog-bot is moving from:

Just generating a changelog automatically

to:

Generating a changelog that fits each project

v1 is getting closer.

If you are interested, please give the repository a ⭐ and watch over it warmly!