captainhook/hook-installer

Composer Plugin that makes everyone activate the CaptainHook git hooks locally

Package info

github.com/captainhook-git/hook-installer

Type:composer-plugin

pkg:composer/captainhook/hook-installer

Statistics

Installs: 963 599

Dependents: 57

Suggesters: 0

Stars: 5

Open Issues: 0

1.0.4 2025-04-08 07:12 UTC

Requires

  • php: >=8.0
  • composer-plugin-api: ^1.1|^2.0

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT fb3c45f6204b08baba999f4ffc4ae707bf684e8b

  • Sebastian Feldmann <sf.woop@sebastian-feldmann.info>

This package is auto-updated.

Last update: 2026-06-08 09:49:53 UTC


README

πŸ‘ Latest Stable Version
πŸ‘ Minimum PHP Version
πŸ‘ Downloads
πŸ‘ License

HookInstaller is a Composer plugin for CaptainHook it takes care of activating your local git hooks after composer install or composer update. If you want to make sure your teammates activate their hooks, install this plugin and you don't have to remind them anymore.

For more information about CaptainHook visit the Website.

Installation:

As this is a Composer plugin you should use Composer to install it.

$ composer require --dev captainhook/hook-installer

For this to work you must have CaptainHook installed already. If you need help installing CaptainHook have a look at the CaptainΒ΄s README

Everything else should happen automagically.

Customize

If you choose to not put your configuration in the default location you can set the path to your CaptainHook configuration file. If you installed CaptainHook without using any of its Composer packages captainhook/captainhook or captainhook/captainhook-phar you have to set the path to the executable. All extra config settings are optional and if you are using the default settings you do not have to configure anything to make it work.

{
 "extra": {
 "captainhook": {
 "config": "config/captainhook.json",
 "exec": "tools/captainhook.phar",
 "force-install": true,
 "only-enabled": true,
 "disable-plugin": false
 } 
 } 
}

A word of warning

It is still possible to commit without invoking the hooks. So make sure you run appropriate backend-sanity checks on your code!