Repolode
carloscuesta

carloscuesta/gitmoji-cli

Cliente interativo de linha de comando para escrever mensagens de commit do Git com prefixos de emoji gitmoji.

Estrelas
4,829
Forks
212
Issues abertas
18
Último commit
há 5 dias

O que é?

gitmoji-cli é um cliente de linha de comando para a convenção gitmoji, que marca mensagens de commit com um emoji que indica o tipo de mudança. Em vez de procurar manualmente na lista de gitmojis, você pode navegar, pesquisar e escolher um emoji pelo terminal. A ferramenta monta a mensagem de commit com base nas suas respostas às perguntas.

A ferramenta oferece duas formas de fazer commits: o modo cliente (`gitmoji -c`), que executa as perguntas e faz o commit diretamente, e o modo hook (`gitmoji -i`), que se integra ao `git commit` para exibir as perguntas a cada commit. Também há comandos para listar todos os gitmojis, pesquisá-los por palavra-chave e sincronizar a lista com o repositório upstream. Um cache local mantém a lista disponível offline.

O comportamento pode ser configurado por meio de uma chave `gitmoji` no package.json, de um arquivo `.gitmojirc.json` ou de uma configuração global. As opções incluem executar `git add` automaticamente, escolher o formato do emoji (código ou emoji), ativar perguntas opcionais sobre a mensagem e o escopo com escopos predefinidos, além de definir uma URL personalizada para a API de gitmojis. A instalação pode ser feita com npm ou Homebrew.

Recursos principais

  • 01Escolha um gitmoji interativamente e monte uma mensagem de commit respondendo a perguntas.
  • 02Funciona no modo cliente ou como hook do git commit.
  • 03Lista e pesquisa todos os gitmojis disponíveis pelo terminal.
  • 04Funciona offline com um cache local e permite sincronizar a lista quando necessário.
  • 05Pode ser configurado pelo package.json, pelo .gitmojirc.json ou por configurações globais.

Casos de uso

  • Manter o histórico de commits consistente em uma equipe que segue a convenção gitmoji.
  • Evitar procurar manualmente códigos de emoji ao escrever mensagens de commit.
  • Impor um formato de commit no projeto instalando o hook de commit.

Início rápido

  1. 1

    Instale o gitmoji-cli globalmente com npm

    npm i -g gitmoji-cli
  2. 2

    Inicie o cliente interativo de commits

    gitmoji -c

Antes de usar

  • Usa emojis como prefixos, por isso só é adequado para equipes que seguem a convenção gitmoji.

Em coleções

Tópicos

#git#commit#cli#emoji#conventional-commits#developer-workflow#gitmoji#gitmoji-cli

Perguntas frequentes

O que é gitmoji-cli?
Cliente interativo de linha de comando para escrever mensagens de commit do Git com prefixos de emoji gitmoji. gitmoji-cli é um cliente de linha de comando para a convenção gitmoji, que marca mensagens de commit com um emoji que indica o tipo de mudança. Em vez de procurar manualmente na lista de gitmojis, você pode navegar, pesquisar e escolher um emoji pelo terminal. A ferramenta monta a mensagem de commit com base nas suas respostas às perguntas.
gitmoji-cli é gratuito? Qual é a licença?
gitmoji-cli é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gitmoji-cli ainda é mantido?
Manutenção ativa. O último commit de gitmoji-cli foi em 2 de nov. de 2026.
Para que posso usar gitmoji-cli?
Manter o histórico de commits consistente em uma equipe que segue a convenção gitmoji. Evitar procurar manualmente códigos de emoji ao escrever mensagens de commit. Impor um formato de commit no projeto instalando o hook de commit.
Como instalar gitmoji-cli?
Instale o gitmoji-cli globalmente com npm: npm i -g gitmoji-cli Inicie o cliente interativo de commits: gitmoji -c
Onde consigo gitmoji-cli?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/carloscuesta/gitmoji-cli

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

Projetos relacionados