GPTChangelog

GPTChangelog generates source-grounded release notes from Git history while keeping release mechanics deterministic and safe.

What it does

• Validates the requested Git range before contacting a model
• Includes the root commit correctly for first releases
• Classifies conventional and inferred commit types
• Calculates the next semantic version locally
• Processes commit messages with GPT-6 Luna, then requests one release-note draft
• Requires source commit IDs for generated entries
• Renders consistent English, French, or Spanish Markdown
• Rejects malformed or duplicate releases
• Updates changelog files atomically
• Produces clean Markdown or JSON for CI pipelines

Models

GPT-6 Luna first processes commit messages using its default reasoning effort. The final changelog uses GPT-6.1 Sol with Codex's default balanced profile, or GPT-5.6 Terra with OpenAI's balanced profile. The quality profile uses GPT-5.6 Sol.

gptchangelog generate --profile balanced
gptchangelog generate --profile quality

Quick start

pip install gptchangelog
export OPENAI_API_KEY='...'
gptchangelog generate

Or reuse a Codex login:

codex login
gptchangelog generate --provider codex

Preview without writing:

gptchangelog generate --dry-run > release.md

Continue with Getting Started or browse the User Guide.