CaptainHook is a flexible Git hook manager for PHP developers that helps teams share and enforce repository workflows through a simple JSON configuration file.
It can run checks before commits and pushes, validate or prepare commit messages, and trigger follow-up tasks after operations such as merges, checkouts, and rebases. The project is designed to make Git hooks easier to maintain across teams while still allowing developers to extend the system with their own PHP logic when needed.
This is free and open source software.
Key Features
- Supports common Git hooks including pre-commit, pre-push, prepare-commit-msg, commit-msg, post-commit, post-checkout, post-merge, and post-rewrite.
- Provides virtual hooks such as post-change to avoid duplicating configuration across related Git events.
- Lets you define hook behaviour in a captainhook.json file with per-hook enable switches and action lists.
- Can execute CLI commands such as test suites, linters, and code quality tools as hook actions.
- Supports custom PHP action classes, static method calls, and custom rules for commit message validation.
- Includes conditions and placeholders so actions can respond to staged files, changed files, hook arguments, environment variables, and configuration values.
- Allows shared and reusable setups by including other CaptainHook configuration files.
- Offers configurable run modes and settings, including support for Docker-based execution.
Website: github.com/captainhook-git/captainhook
Support:
Developer: Sebastian Feldmann
License: MIT License
CaptainHook is written in PHP. Learn PHP with our recommended free books and free tutorials.
Related Software
| Git Hook Managers | |
|---|---|
| lefthook | Git hooks manager for Node.js, Ruby, Python and more |
| husky | Git hooks made easy |
| pre-commit | Manage and maintain multi-language pre-commit hooks |
| overcommit | Manage and configure Git hooks |
| hk | Git hooks manager and project linting tool focusing on performance |
| simple-git-hooks | Simple git hooks manager for small projects |
| git-hooks | Rewritten from icefox/git-hooks, with extra features |
| Jig | Git pre-commit hook on steroids |
Read our verdict in the software roundup.
 Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |