| hide |
|
||
|---|---|---|---|
| template | home.html | ||
| title | Commit Check |
-
:material-chart-line: Free & Powerful
A fully open-source solution for validating commits, branches, and more — simple, reliable, and community-driven.
-
:material-cog: Zero Configuration
Works right out of the box with smart defaults. Power users can easily customize rules to fit their team’s workflow.
-
:material-devices: Works Everywhere
GitHub Actions, pre-commit hooks, or the command line — integrate Commit Check anywhere your code lives.
Used by developers and organizations worldwide in their production workflows.
=== "GitHub Actions"
Add Commit Check Action to your workflow in seconds:
```yaml
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' }}
```
=== "Pre-commit"
Add Commit Check to your `.pre-commit-config.yaml`:
```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
```
=== "Command Line"
Install and run locally:
```bash
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...
```
Be part of a growing ecosystem of developers who care about Commit Check.
GitHub Issue :fontawesome-brands-github:{ .md-button } GitHub Pull Request :fontawesome-brands-github:{ .md-button }







