Repolode
Enviar
Everduin94

Everduin94/better-commits

Uma CLI em TypeScript que orienta a criação de mensagens Conventional Commits, com inferência baseada no nome da branch e comandos auxiliares para branches e worktrees.

Ver no GitHub
Estrelas
2,284
Forks
80
Issues abertas
6
Último commit
há 2 meses

O que é?

better-commits é uma ferramenta de linha de comando que cria mensagens de commit git seguindo a especificação Conventional Commits. Em vez de digitar o formato manualmente, você responde a uma série de perguntas sobre o tipo de commit, o escopo, o ticket, o título, o corpo e os rodapés; depois, confere uma prévia antes de criar o commit.

A ferramenta infere o número do ticket, o tipo de commit e o escopo com base no nome da branch atual, preenchendo automaticamente os valores mais comuns. A configuração fica em um arquivo .better-commits.jsonc, que pode ser definido globalmente ou por repositório, e inclui a lista de tipos, emojis, limites de tamanho do título e muito mais. Um comando complementar, better-branch, cria branches ou worktrees com nomes formatados de maneira consistente e pode executar hooks antes e depois da criação.

Para automação, o modo --no-interactive, com flags da CLI, permite que scripts e agentes de programação criem commits sem prompts; já --dry-run valida o comando git commit resultante.

Recursos principais

  • 01Cria mensagens Conventional Commits com perguntas guiadas e uma prévia antes de fazer o commit
  • 02Infere o ticket, o escopo e o tipo de commit com base no nome da branch
  • 03Permite configurar globalmente ou por repositório usando um arquivo de configuração JSONC
  • 04Cria branches ou worktrees com nomes consistentes usando better-branch
  • 05Oferece modo não interativo com flags da CLI para scripts e agentes de programação

Casos de uso

  • Manter o histórico de commits consistente em equipes que seguem Conventional Commits
  • Preencher automaticamente os campos de ticket e escopo com base em nomes de branch, como feature/TICKET-123-description
  • Permitir que agentes de programação com IA gerem mensagens de commit padronizadas sem prompts interativos
  • Criar git worktrees para cada branch de funcionalidade com nomes de pasta previsíveis

Início rápido

  1. 1

    Instale a CLI globalmente com npm (requer Node.js 20 ou superior)

    npm install -g better-commits
  2. 2

    Execute a CLI no seu repositório para criar um commit

    better-commits

Antes de usar

  • Requer Node.js 20 ou superior.

Tópicos

#git#commit-message#conventional-commits#cli#typescript#developer-tools#clack#zod

Perguntas frequentes

O que é better-commits?
Uma CLI em TypeScript que orienta a criação de mensagens Conventional Commits, com inferência baseada no nome da branch e comandos auxiliares para branches e worktrees. better-commits é uma ferramenta de linha de comando que cria mensagens de commit git seguindo a especificação Conventional Commits. Em vez de digitar o formato manualmente, você responde a uma série de perguntas sobre o tipo de commit, o escopo, o ticket, o título, o corpo e os rodapés; depois, confere uma prévia antes de criar o commit.
better-commits é gratuito? Qual é a licença?
better-commits é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
better-commits ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de better-commits foi em 26 de ago. de 2026.
Para que posso usar better-commits?
Manter o histórico de commits consistente em equipes que seguem Conventional Commits Preencher automaticamente os campos de ticket e escopo com base em nomes de branch, como feature/TICKET-123-description Permitir que agentes de programação com IA gerem mensagens de commit padronizadas sem prompts interativos Criar git worktrees para cada branch de funcionalidade com nomes de pasta previsíveis
Como instalar better-commits?
Instale a CLI globalmente com npm (requer Node.js 20 ou superior): npm install -g better-commits Execute a CLI no seu repositório para criar um commit: better-commits
Onde consigo better-commits?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Everduin94/better-commits

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados