evilmartians/lefthook

O que é?

Recursos principais

• 01Executa comandos de hooks em paralelo para acelerar as verificações de pre-commit e pre-push.
• 02Filtra os arquivos por job usando padrões glob, exclusões e listas de arquivos staged.
• 03Agrupa jobs por tags e permite incluí-los ou excluí-los em cada hook.
• 04Permite executar jobs em subdiretórios, arquivos de script e containers Docker.
• 05Permite que cada pessoa desenvolvedora mantenha suas próprias substituições em um arquivo de configuração local.

Casos de uso

• Executar ESLint, Stylelint ou RuboCop nos arquivos staged antes de cada commit.
• Auditar dependências ou executar verificações de segurança antes de um push.
• Impor modelos de mensagem de commit com um script commit-msg.
• Compartilhar um conjunto de fixers para toda a equipe, que pode ser executado sob demanda com lefthook run.

Início rápido

1. 1

   Instale o lefthook com npm como dependência de desenvolvimento

   npm install lefthook --save-dev
2. 2

   Configure seus hooks em lefthook.yml

3. 3

   Instale os hooks no projeto Git

   lefthook install

Antes de usar

• !Alguns detalhes de configuração e uso estão disponíveis apenas no site de documentação externo.

Tópicos

Perguntas frequentes

O que é lefthook?

Gerenciador rápido de Git hooks escrito em Go, que executa comandos de pre-commit e outros hooks em paralelo em projetos Node.js, Ruby, Python e outras tecnologias. O Lefthook gerencia os Git hooks de um projeto por meio de um único arquivo lefthook.yml. Você define comandos para hooks como pre-commit, pre-push ou commit-msg e, em seguida, executa lefthook install uma vez para configurá-los no repositório. Ele é distribuído como um único binário sem dependências e também pode ser instalado via npm, gem, pipx, Go, Homebrew, apt, winget e outros gerenciadores de pacotes.

lefthook é gratuito? Qual é a licença?

lefthook é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

lefthook ainda é mantido?

Manutenção ativa. O último commit de lefthook foi em 21 de out. de 2026.

Para que posso usar lefthook?

Executar ESLint, Stylelint ou RuboCop nos arquivos staged antes de cada commit. Auditar dependências ou executar verificações de segurança antes de um push. Impor modelos de mensagem de commit com um script commit-msg. Compartilhar um conjunto de fixers para toda a equipe, que pode ser executado sob demanda com lefthook run.

Como instalar lefthook?

Instale o lefthook com npm como dependência de desenvolvimento: npm install lefthook --save-dev Configure seus hooks em lefthook.yml Instale os hooks no projeto Git: lefthook install

Onde consigo lefthook?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/evilmartians/lefthook