HelixCommit

Turn Git history into polished, publish-ready release notes

HelixCommit transforms your Git commit history into professional release notes automatically. It understands Conventional Commits, enriches entries with GitHub pull requests, and can generate AI-powered summaries.

Get started in seconds

1. Install HelixCommit

   pip install helixcommit
   
2. Generate release notes

   helixcommit generate --unreleased --format markdown
   

Works completely offline with no GitHub API calls or external dependencies required.

---

Explore the documentation

Quick start

Generate your first release notes in under 5 minutes

Installation

Install HelixCommit using pip or from source

CLI reference

Complete guide to all CLI commands and options

Python API

Integrate HelixCommit programmatically in your Python projects

Community

Join our Discord server and connect with other users

---

Key features

Automated changelog

Build structured release notes from commits and tags automatically.

AI summaries

Generate intelligent, context-aware summaries with OpenAI or OpenRouter.

Conventional Commits

Automatically detects commit types, scopes, and breaking changes.

GitHub enrichment

Resolves pull requests and links for richer context.

Multiple formats

Export as Markdown, HTML, or plain text.

Fast & resilient

Uses GitPython with automatic CLI fallback.

---

Common use cases

Generate release notes between two tags

helixcommit generate \
  --since-tag v1.2.0 \
  --until-tag v1.2.1 \
  --format markdown \
  --out release-v1.2.1.md

Perfect for creating release notes when cutting a new version.

Create release notes for unreleased changes

helixcommit generate \
  --unreleased \
  --format html \
  --out preview.html

Preview what’s changed since your last release before tagging.

Generate AI-enhanced summaries

export OPENAI_API_KEY=sk-...

helixcommit generate \
  --unreleased \
  --use-llm \
  --openai-model gpt-4o-mini \
  --format markdown

Let AI summarize your changes with intelligent, context-aware descriptions.

Integrate with CI/CD pipelines

- name: Generate release notes
  run: |
    pip install helixcommit
    helixcommit generate \
      --since-tag ${{ github.event.release.target_commitish }} \
      --until-tag ${{ github.event.release.tag_name }} \
      --format markdown \
      --out RELEASE_NOTES.md

Automate release note generation in your GitHub Actions workflows.

---

Next steps

Follow the quickstart

Generate your first release notes and explore the basic features

Explore examples

See real-world examples and common usage patterns

Configure for your workflow

Customize HelixCommit to match your team’s needs

GitHub integration

Enrich release notes with PR data and links