Custom commit hooks for use with pre-commit that enhance conventional commit messages with better context and consistency.

• 🎯 Automatic scope enhancement - Add filenames as scopes to single-file commits
• 🔀 Conventional merge commits - Transform merge commits to follow conventional commit format
• ⚡ Zero configuration - Works out of the box with sensible defaults
• 📏 Smart formatting - Respects commit message length limits (50 character summary)

• pre-commit installed in your repository
• Git repository following Conventional Commits format

Add the following to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/michen00/custom-commit-hooks
    rev: v0.0.4 # Use the latest version
    hooks:
      - id: enhance-scope
      - id: conventional-merge-commit

Then install the hooks:

pre-commit install --hook-type commit-msg --hook-type prepare-commit-msg

Automatically adds the filename as the scope to conventional commit messages for single-file commits, improving commit history readability.

When you commit changes to a single file with a conventional commit message that lacks a scope, this hook automatically adds the filename as the scope.

The hook only modifies commits when all of the following conditions are met:

• ✅ Exactly one file is being committed
• ✅ Commit message follows conventional commit format (e.g., feat:, fix:, docs:, etc.)
• ✅ No pre-existing scope in the commit message
• ✅ The filename doesn't already appear in the commit summary
• ✅ Adding the filename scope keeps the summary under 50 characters

Before:

build: add a dependency

After:

build(pyproject.toml): add a dependency

Transforms Git's default merge commit messages to follow conventional commit format.

Git's default merge commit summaries begin with Merge ..., which doesn't conform to conventional commit format. This hook automatically prefixes merge commits with chore: merge ... instead.

Before:

Merge branch 'feature/new-api' into main

After:

chore: merge branch 'feature/new-api' into main