Repolode
Enviar
guanguans

guanguans/ai-commit

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.

Ver no GitHub
Estrelas
393
Forks
22
Issues abertas
0
Último commit
há 4 dias

O que é?

ai-commit é uma ferramenta de linha de comando em PHP que lê seu git diff, envia o conteúdo para um gerador de IA e cria uma mensagem de commit convencional com tipo, assunto e corpo. Você pode revisar e editar a mensagem antes de fazer o commit ou usar uma execução de teste para apenas exibir o resultado.

A ferramenta oferece suporte a vários backends, incluindo OpenAI, OpenAI Chat, Moonshot, ERNIE Bot, Bito CLI, GitHub Copilot CLI e GitHub Models CLI. O gerador padrão e as chaves de API são definidos por meio de um comando de configuração. A ferramenta também inclui comandos para listar opções, editar a configuração e atualizar o binário compilado.

Instale baixando o arquivo único ai-commit do repositório ou usando o Composer. É necessário ter PHP 8.2 ou mais recente.

Recursos principais

  • 01Gera mensagens de commit convencionais com base no conteúdo do git diff.
  • 02Permite escolher o tipo de commit e revisar a mensagem antes de confirmar.
  • 03Oferece suporte a vários backends de IA, como OpenAI, Moonshot e ERNIE Bot.
  • 04Disponibiliza um modo de execução de teste que apenas exibe a mensagem gerada.
  • 05É distribuída como um único arquivo para download ou pode ser instalada via Composer.

Casos de uso

  • Escrever mensagens de commit consistentes em projetos que seguem o formato Conventional Commits.
  • Agilizar commits quando as alterações são grandes e resumir tudo manualmente dá trabalho.
  • Usar uma configuração existente do GitHub Copilot ou do Bito CLI para gerar mensagens de commit.

Início rápido

  1. 1

    Instale globalmente com o Composer (requer PHP 8.2 ou superior)

    composer global require guanguans/ai-commit --dev -v
  2. 2

    Configure a chave de API do seu gerador de IA (o exemplo usa OpenAI Chat)

    ai-commit config set generators.openai_chat.api_key sk-... --global
  3. 3

    Prepare as alterações, gere a mensagem e faça o commit

    ai-commit commit

Antes de usar

  • Requer PHP 8.2 ou superior.
  • A maioria dos geradores precisa de uma chave de API ou de uma ferramenta CLI instalada separadamente.

Em coleções

Ferramentas de CLI e terminal

Tópicos

#git#commit-message#conventional-commits#openai#llm#cli#php#ai#bito#changelog

Perguntas frequentes

O que é ai-commit?
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. ai-commit é uma ferramenta de linha de comando em PHP que lê seu git diff, envia o conteúdo para um gerador de IA e cria uma mensagem de commit convencional com tipo, assunto e corpo. Você pode revisar e editar a mensagem antes de fazer o commit ou usar uma execução de teste para apenas exibir o resultado.
ai-commit é gratuito? Qual é a licença?
ai-commit é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ai-commit ainda é mantido?
Manutenção ativa. O último commit de ai-commit foi em 3 de nov. de 2026.
Para que posso usar ai-commit?
Escrever mensagens de commit consistentes em projetos que seguem o formato Conventional Commits. Agilizar commits quando as alterações são grandes e resumir tudo manualmente dá trabalho. Usar uma configuração existente do GitHub Copilot ou do Bito CLI para gerar mensagens de commit.
Como instalar ai-commit?
Instale globalmente com o Composer (requer PHP 8.2 ou superior): composer global require guanguans/ai-commit --dev -v Configure a chave de API do seu gerador de IA (o exemplo usa OpenAI Chat): ai-commit config set generators.openai_chat.api_key sk-... --global Prepare as alterações, gere a mensagem e faça o commit: ai-commit commit
Onde consigo ai-commit?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/guanguans/ai-commit

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

Projetos relacionados