Captain Hook Plugin to check if commit author is valid (e.g. email in whitelist)

v0.8.0 2023-01-01 19:02 UTC


This package provides an action for Captain Hook which will reject a commit when author name or email does not match a regex defined in the captainhook.json configuration file. Use this action if you want to make sure that your private email address does not end up in your companies' git repositories.

Build Status Coverage Status Infection MSI


The preferred way of installing bitexpert/captainhook-validateauthor is through Composer. You can add bitexpert/captainhook-validateauthor as a dev dependency, as follows:

composer.phar require --dev bitexpert/captainhook-validateauthor


Add the following code to your captainhook.json configuration file:

  "pre-commit": {
    "enabled": true,
    "actions": [
        "action": "\\bitExpert\\CaptainHook\\ValidateAuthor\\ValidateAuthorAction",
        "options": {
            "name": "/^[A-Za-z0-09]+$/",
            "email": "/$/"

Captain Hook will now check on every commit if author name and email match the defined regex. If not, the commit will be canceled.


Please feel free to fork and extend existing or add new features and send a pull request with your changes! To establish a consistent code quality, please provide unit tests for all your changes and adapt the documentation.

Want To Contribute?

If you feel that you have something to share, then we’d love to have you. Check out the contributing guide to find out how, as well as what we expect from you.


Captain Hook Validate Author Action is released under the Apache 2.0 license.