remotes

You can provide multiple remote configs if you want to share yours lefthook configurations across many projects. Lefthook will automatically download and merge configurations into your local lefthook.yml.

You can use extends but the paths must be relative to the remote repository root.

If you provide scripts in a remote config file, the scripts folder must also be in the root of the repository.

Note

Configs are merged in this order: lefthook.yml → remotes → lefthook-local.yml. For simplicity, keep jobs in remote configs independent from other steps.

Example

# lefthook.yml

remotes:
  - git_url: git@github.com:evilmartians/lefthook
    ref: v1.0.0
    configs:
      - examples/ruby-linter.yml