Pitch: Seshat: Automatizando commits com IA · juniormartinxo

Que atire a primeira pedra o dev que nunca passou um bom tempo pensando em como escrever a melhor mensagem de commit para cada nova funcionalidade ou correção de bug! Ou então, depois de realizar várias mudanças no código, vê que é difícil explicar claramente o que foi feito. Quem nunca?!

Pensando nesta dor, que eu também era vítima, resolvi desenvolver o Seshat: uma ferramenta Open Source de linha de comando (CLI) impulsionada por Inteligência Artificial que gera mensagens de commit seguindo o padrão Conventional Commits de forma rápida e descomplicada. A sua produtividade vai decolar!

Mas o que é o Seshat?

O Seshat é um CLI que analisa automaticamente o seu código antes do commit, verificando as mudanças (diff) e sugerindo uma mensagem de commit pronta. Ele segue rigorosamente o padrão Conventional Commits, facilitando a manutenção do histórico do seu projeto e garantindo uma melhor organização das modificações com tipos (feat, fix, docs, etc.), escopo, indicação de breaking changes e muito mais.

O nome Seshat homenageia a deusa egípcia da escrita e dos registros — e é exatamente isso que a ferramenta faz: registra seus commits com clareza e inteligência!

Principais destaques

1. Mensagens de Commit Padronizadas

Utilize automaticamente o Conventional Commits, facilitando a navegação no histórico do projeto e a geração de CHANGELOGs consistentes.

2. Múltiplos Provedores de IA

O Seshat conversa com diferentes APIs de IA (como DeepSeek, Claude e Ollama). Assim, você pode escolher a melhor opção de acordo com sua infraestrutura e preferências.

3. Análise de Diff e Tamanho

A ferramenta checa automaticamente as linhas de código alteradas. Se o diff for muito extenso, o Seshat avisa, incentivando a prática de criar commits menores e mais focados.

4. Confirmação Interativa

Depois de gerar a mensagem de commit, você pode revisar e decidir se quer confirmá-la ou fazer ajustes. Também é possível rodar tudo em modo “sem perguntas” (usando a flag --yes) para fluxos de trabalho mais rápidos.

5. Integração com Git Simplificada

O Seshat se integra facilmente ao Git. Basta adicionar seus arquivos com git add e, em seguida, rodar o comando do seshat. Ele assume todo o processo de criação da mensagem, validação e commit final.

6. Configuração Flexível

Você controla tudo via variáveis de ambiente ou pela própria CLI, incluindo chave de API, modelo de IA, provedor, limites de diff etc. É muita liberdade para adaptar ao seu estilo de trabalho.

Tá, mas como funciona?

1. Instalação

A maneira mais prática é via pipx (que isola cada CLI em um ambiente próprio), mas você também pode instalar usando pip:

# Com pipx
pipx install git+https://github.com/juniormartinxo/seshat.git

# Ou com pip
pip install git+https://github.com/juniormartinxo/seshat.git

2. Configuração

Se você for utilizar um provedor de IA remoto, basta configurar a chave de API e o modelo:

seshat config --provider deepseek
seshat config --api-key SUAS_CHAVE_AQUI
seshat config --model deepseek-coder-v2

Ou simplesmente usar ollama em ambiente local, caso prefira rodar a IA localmente.

3. Usando o Seshat

Depois de adicionar as modificações ao stage:

git add .
seshat commit

O Seshat analisará o diff, criará uma mensagem de commit coerente e perguntará se você deseja confirmar. Você pode inspecionar, editar ou mesmo cancelar. Se já estiver confiante no processo, use o --yes para pular a confirmação interativa:

seshat commit --yes

4. Fluxo Avançado

Se você gosta de fazer vários pequenos commits, pode usar o comando seshat flow para iterar arquivo por arquivo, adicionando cada alteração individualmente. Assim, você mantém seu repositório organizado e com commits super descritivos, sem trabalho extra.

Benefícios para o Seu Projeto

Velocidade e Produtividade: Chega de ficar pensando na formatação perfeita do commit. Deixe que a IA gere o esboço rapidamente, e você só valida.

Padronização e Organização: Graças ao Conventional Commits, o histórico do seu projeto fica mais fácil de entender. Gerar CHANGELOG, encontrar onde um bug surgiu ou rastrear quando uma feature foi introduzida se torna muito mais simples.

Aprendizado Contínuo: Se você está começando a adotar boas práticas de versionamento, o Seshat serve como um guia prático. Você já aprende com exemplos de commits bem formatados.

Colaboração Facilitada: Em equipes, cada membro escreve mensagens de commit de forma mais uniforme. A comunicação interna melhora bastante!

Por que vale a pena experimentar?

Em essência, o Seshat cria um atalho mental para a tarefa de resumir mudanças no código. Ele encurta o tempo que você gastaria pensando em como explicar cada commit e ainda educa sobre as boas práticas de versionamento. É como ter um mentor de git sempre presente, polindo suas mensagens e ajudando você a deixar tudo mais profissional.

Quer um pipeline de desenvolvimento mais enxuto, sem abrir mão de qualidade e documentação? O Seshat pode ser o próximo passo para turbinar o seu fluxo de trabalho.

Conclusão

Se você é desenvolvedor, mantenedor de projetos open source ou simplesmente alguém que busca praticidade na hora de versionar o código, o Seshat se torna um aliado inestimável. Além de aumentar a produtividade, ele incentiva as boas práticas no seu repositório.

Ficou curioso? Você pode encontrar o projeto no GitHub, experimentar a instalação e começar hoje mesmo a escrever commits mais claros, padronizados e profissionais. Depois, volte e compartilhe sua experiência com a comunidade no TabNews!

E então, pronto para dar o próximo passo na evolução dos seus commits? É só começar a usar o Seshat. Garanto que você não vai mais querer voltar ao método manual!

E aí, gostou?

Compartilhe com outros desenvolvedores que também querem economizar tempo e manter um histórico de projeto impecável. Experimente o Seshat agora e dê um salto na forma como você gerencia seus commits!

Link para o projeto: https://github.com/juniormartinxo/seshat