Skip to content

Commit Check

Automate commit and branch validation — simple, consistent, and configurable.

Get started

Commit Check

Everything you need for commit-check

  • Free & Powerful


    A fully open-source solution for validating commits, branches, and more — simple, reliable, and community-driven.

  • Zero Configuration


    Works right out of the box with smart defaults. Power users can easily customize rules to fit their team’s workflow.

  • Works Everywhere


    GitHub Actions, pre-commit hooks, or the command line — integrate Commit Check anywhere your code lives.

Trusted by developers worldwide

Used by developers and organizations worldwide in their production workflows.

Apache Apache
Discovery Unicamp Discovery Unicamp
Texas Instruments Texas Instruments
OpenCADC OpenCADC
Extrawest Extrawest
Chainlift Chainlift
Mila Mila
RLinf RLinf

Quick Start

Add Commit Check Action to your workflow in seconds:

steps:
  - uses: actions/checkout@v5
    with:
      ref: ${{ github.event.pull_request.head.sha }}  # Checkout PR HEAD commit
      fetch-depth: 0  # Required for merge-base checks
  - uses: commit-check/commit-check-action@v2
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Needed for PR comments
    with:
      message: true
      branch: true
      author-name: true
      author-email: true
      job-summary: true
      pr-comments: ${{ github.event_name == 'pull_request' }}

Add Commit Check to your .pre-commit-config.yaml:

repos:
  repo: https://github.com/commit-check/commit-check
  rev: <tag or revision>
  hooks:
  -   id: check-message
  -   id: check-branch
  -   id: check-author-name
  -   id: check-author-email

Install and run locally:

pip install commit-check

# Validate message from STDIN
echo "feat: new feature" | commit-check -m

# Validate message from file
commit-check -m commit_message.txt

# Validate the latest git commit message
commit-check -m

# And more...

Join Our Community

Be part of a growing ecosystem of developers who care about Commit Check.

GitHub Issue GitHub Pull Request