# github-changelog-generator/github-changelog-generator

Automatically generate change log from your tags, issues, labels and pull requests on GitHub.

Repository: https://github.com/github-changelog-generator/github-changelog-generator
Canonical: https://ross.abutalabs.com/products/github-changelog-generator
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, labels, generator, github-api, github-extension, changelog, markdown, changelog-generator, notable-changes, hacktoberfest
Last push: 2026-03-18T00:32:15+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 75, longevity 100
- inputs: {"age_days": 4324, "days_push": 169, "days_rel": 169, "gap_med": 4, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7539, forks 844 (observed 2026-08-28T04:10:00.629307+00:00)

## What it is
A Ruby gem and CLI tool that automatically generates a CHANGELOG.md file from GitHub tags, issues, labels, and merged pull requests. It groups notable changes into separate lists by label so releases can be documented without manual editing.

## Use cases
- generate a changelog from GitHub issues and pull requests
- automatically create release notes for a new version
- stop maintaining CHANGELOG.md by hand
- split changelog entries by issue labels
- create GitHub release notes from merged PRs
- run changelog generation in CI or Docker

## When to choose
- your project is hosted on GitHub and uses tags, issues, and PRs
- you want fully automated, repeatable changelog generation
- you want entries categorized by labels like bug or feature
- you want a CLI, rake task, or Docker-based workflow

## When to avoid
- your repository is not on GitHub
- you need changelogs from GitLab, Bitbucket, or plain git history without GitHub metadata
- you need fine-grained custom changelog formats the tool's options cannot express
- you prefer manually curated changelogs

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, documentation, markdown, cli
- domain: developer-tools, version-control, documentation
- platform: cli, cross-platform
- tags: changelog-generator, github-api, release-notes, ruby-gem, automation, command-line, docker

## Member repositories
- github-changelog-generator/github-changelog-generator (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:00.629307+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:37:25.840839+00:00, confidence not recorded.
  - readme: https://github.com/github-changelog-generator/github-changelog-generator (fetched 2026-08-28T04:10:00.629307+00:00, sha 0eec4cd2a4ed)
- Data as of 2026-08-30T08:39:29.467469+00:00.