# git-chglog/git-chglog

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/git-chglog-git-chglog).**

2,874 stars · 224 forks · Go · MIT · archived

## Links

- GitHub: https://github.com/git-chglog/git-chglog
- Homepage: https://git-cliff.org/
- awesome-repositories: https://awesome-repositories.com/repository/git-chglog-git-chglog.md

## Topics

`changelog` `cli` `command-line-tool` `git` `git-chglog` `github` `gitlab` `go` `golang` `golang-package` `jira` `keep-a-changelog`

## Description

Git-chglog is a command-line tool designed to automate the generation of project changelogs by parsing Git commit history. It functions as a documentation utility that transforms raw repository logs into structured, human-readable release notes based on user-defined templates and configuration rules.

The tool distinguishes itself through a configuration-driven pipeline that allows for granular control over how commit history is filtered, sorted, and categorized. By utilizing regular expressions and support for conventional commit standards, it organizes commit messages into logical sections. Furthermore, it provides integration with external issue trackers, enabling the injection of supplementary metadata into the generated documentation to improve traceability between code changes and project management records.

The system supports a wide range of customization options, including the ability to define custom output templates and formatting functions to match specific project requirements. It is designed to be incorporated into development workflows and build pipelines, facilitating consistent documentation practices without manual intervention.

## Tags

### Development Tools & Productivity

- [Release Changelog Generators](https://awesome-repositories.com/f/development-tools-productivity/project-changelogs/release-changelog-generators.md) — Generates structured release changelogs by parsing Git commit history according to user-defined templates and standards.
- [Git-History-Based Reverters](https://awesome-repositories.com/f/development-tools-productivity/git-history-based-reverters.md) — Extracts structured data by traversing the Git revision graph and applying pattern matching to commit message bodies.
- [Multi-Criteria Commit Filters](https://awesome-repositories.com/f/development-tools-productivity/commit-history-analysis/commit-type-filtering/multi-criteria-commit-filters.md) — Filters commit history by matching tag patterns, file paths, or text content to exclude irrelevant entries. ([source](https://github.com/git-chglog/git-chglog/blob/master/CHANGELOG.md))
- [Regex Categorization Rules](https://awesome-repositories.com/f/development-tools-productivity/commit-management/regex-categorization-rules.md) — Groups and filters commit messages into logical sections using user-defined regular expressions.
- [Commit Standards](https://awesome-repositories.com/f/development-tools-productivity/commit-standards.md) — Structures project history by identifying and categorizing commit messages that follow standard naming conventions.
- [Configuration-Driven Orchestrators](https://awesome-repositories.com/f/development-tools-productivity/configuration-driven-orchestrators.md) — Orchestrates changelog generation processes using declarative configuration files to define filtering, sorting, and rendering rules.
- [Commit Metadata Organizers](https://awesome-repositories.com/f/development-tools-productivity/contribution-guidelines/structured-commit-histories/commit-metadata-organizers.md) — Organizes commit history by grouping and arranging messages based on regex patterns and custom sorting logic. ([source](https://github.com/git-chglog/git-chglog/blob/master/chglog.go))
- [Issue Tracking Integrations](https://awesome-repositories.com/f/development-tools-productivity/issue-tracking-integrations.md) — Integrates external issue tracking systems into the changelog generation process to provide traceability between code changes and project management records.
- [Project Changelogs](https://awesome-repositories.com/f/development-tools-productivity/project-changelogs.md) — Automates the production of project changelog files by parsing commit history and applying user-defined templates. ([source](https://github.com/git-chglog/git-chglog#readme))

### Content Management & Publishing

- [Automated Document Generation](https://awesome-repositories.com/f/content-management-publishing/automated-document-generation.md) — Automates the transformation of Git commit history into structured, formatted documentation through configurable pipelines.

### Data & Databases

- [Conventional Commit Parsers](https://awesome-repositories.com/f/data-databases/atomic-commit-logs/catalog-based-commit-coordinators/commit-message-parsers/conventional-commit-parsers.md) — Identifies and categorizes commit messages following the Conventional Commits standard to structure changelog content. ([source](https://git-cliff.org/))

### Business & Productivity Software

- [Document Templating Engines](https://awesome-repositories.com/f/business-productivity-software/document-templating-engines.md) — Transforms parsed commit data into human-readable documents by injecting structured information into predefined text templates.

### Software Engineering & Architecture

- [Issue Tracker Metadata Injections](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/dependency-injection/event-handler-injection/external-data-injections/issue-tracker-metadata-injections.md) — Enriches generated changelogs by fetching and merging supplementary metadata from remote issue trackers.