Cliente interativo de linha de comando para escrever mensagens de commit do Git com prefixos de emoji gitmoji.
orhun/git-cliff
Uma CLI em Rust que gera changelogs a partir do histórico do Git usando Conventional Commits, parsers de regex personalizáveis e templates.
- Estrelas
- 12,504
- Forks
- 364
- Issues abertas
- 117
- Último commit
- há 6 dias
O que é?
git-cliff cria arquivos de changelog diretamente a partir do histórico do Git de um repositório. Ele interpreta commits que seguem a especificação Conventional Commits e também pode usar parsers de commits personalizados baseados em regex para projetos que adotam outros formatos de mensagem.
O resultado é definido por um template de changelog, controlado por um arquivo de configuração. É possível ajustar o agrupamento e a formatação dos commits para atender ao estilo de changelog que o projeto precisa.
A ferramenta é escrita em Rust e distribuída como um programa de linha de comando independente. A documentação abrange instalação, uso, configuração e criação de templates.
Recursos principais
- 01Gera changelogs a partir do histórico de commits do Git.
- 02Interpreta Conventional Commits por padrão.
- 03Oferece suporte a parsers de commits personalizados baseados em regex.
- 04Permite personalizar o resultado por meio de um arquivo de configuração e templates.
- 05É distribuída como um programa de linha de comando independente escrito em Rust.
Casos de uso
- Gerar automaticamente um CHANGELOG.md durante o processo de lançamento de uma versão.
- Criar notas de versão a partir de commits que seguem Conventional Commits.
- Manter um changelog para um projeto cujas mensagens de commit usam um formato personalizado.
Início rápido
- 1
Instale o git-cliff seguindo o guia de instalação na documentação oficial
- 2
Consulte os exemplos de uso na documentação oficial
Em coleções
Tópicos
Perguntas frequentes
- O que é git-cliff?
- Uma CLI em Rust que gera changelogs a partir do histórico do Git usando Conventional Commits, parsers de regex personalizáveis e templates. git-cliff cria arquivos de changelog diretamente a partir do histórico do Git de um repositório. Ele interpreta commits que seguem a especificação Conventional Commits e também pode usar parsers de commits personalizados baseados em regex para projetos que adotam outros formatos de mensagem.
- git-cliff é gratuito? Qual é a licença?
- git-cliff é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- git-cliff ainda é mantido?
- Manutenção ativa. O último commit de git-cliff foi em 2 de nov. de 2026.
- Para que posso usar git-cliff?
- Gerar automaticamente um CHANGELOG.md durante o processo de lançamento de uma versão. Criar notas de versão a partir de commits que seguem Conventional Commits. Manter um changelog para um projeto cujas mensagens de commit usam um formato personalizado.
- Como instalar git-cliff?
- Instale o git-cliff seguindo o guia de instalação na documentação oficial Consulte os exemplos de uso na documentação oficial
- Onde consigo git-cliff?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/orhun/git-cliff
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Uma ferramenta CLI para gerenciar versões de pacotes, changelogs e publicações em monorepos, com base em arquivos changeset adicionados pelos colaboradores junto com suas alterações.
Ferramenta CLI genérica que automatiza atualizações de versão, tags no Git, changelogs, releases no GitHub/GitLab e publicação no npm.
Uma ferramenta de CLI que gera mensagens de commit convencionais a partir do diff staged do Git usando modelos de IA e, em seguida, faz o commit.
Uma CLI que automatiza o npm publish com verificações prévias, atualização de versão, tags do git, testes e pushes, reunindo o processo de release em uma execução interativa.
Automatiza changelogs, releases no GitHub e atualizações de versão, interpretando Conventional Commits para criar um PR de release.