convez.ai
AgenteProdutividadeIntermediário
jaytan3966

messygit

jaytan3966/messygit

CLI agentic que transforma workflows git bagunçados em commits convencionais limpos

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent CLI que gera commits convencionais automáticos a partir de diffs staged usando Claude. Oferece uma REPL interativa para stage, commit, push e sugestões de próximos passos no projeto, tudo integrado em uma única interface.

Instalação

$npx convez-ai jaytan3966/messygit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
v0.4.5
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar mensagens de commit semânticas automaticamente
  • Obter sugestões de AI sobre próximas etapas do projeto
  • Streamline do workflow git com REPL persistente
  • Padronizar commits em equipes usando Conventional Commits

Veredito

Ferramenta sólida que resolve um problema real: automatizar mensagens de commit com IA mantendo segurança (só envia staged diff). A REPL interativa é bem pensada, mas exige Python 3.10+ e setup local — melhor para desenvolvedores que querem standards de commit aplicados consistentemente.

README

A tradução para o português deste README ainda está na fila.

messygit

messygit is an interactive CLI that turns messy git workflows into clean Conventional Commits — stage, commit, push, and get AI-powered project suggestions, all from one interface powered by Claude.

Why use it

  • Interactive REPL — one command drops you into a persistent session where you can stage, commit, push, and more without leaving.
  • AI commit messages — sends your staged diff to Claude and suggests a clean Conventional Commits subject line.
  • Project suggestions — an AI agent inspects your repo and recommends concrete next steps.
  • Safe by default — only the staged diff is sent to the model. Your API key is never printed in full.

Requirements

  • Python 3.10 or newer
  • Git (run inside a repository)
  • An Anthropic API key with access to the Messages API

Installation

pip install messygit

Install from source

cd messygit
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

API key

messygit resolves the key in this order:

  1. Environment variable ANTHROPIC_API_KEY
  2. Config file ~/.messygit/config.json

You can set the key from within the messygit interface:

messygit > config YOUR_ANTHROPIC_API_KEY

Usage

messygit

This drops you into the interactive interface:

 mmm    mmm  eeeeeee  sssssss  sssssss  yy   yy  ggggggg  ii  tttttttt
 mm mm mm m  ee       ss       ss        yy yy   gg       ii     tt
 mm  mmm  m  eeeee    sssssss  sssssss    yyy    gg  ggg  ii     tt
 mm       m  ee            ss       ss    yy     gg   gg  ii     tt
 mm       m  eeeeeee  sssssss  sssssss   yy      ggggg   ii     tt

Type 'help' for commands, 'quit' to exit.

messygit >

Commands

CommandDescription
add <file> or add .Stage files for commit
commitGenerate an AI commit message from staged changes, then commit / cancel / edit
pushPush commits to remote
suggestionGet AI-powered next-step suggestions for your project
config <key>Save your Anthropic API key to ~/.messygit/config.json
showDisplay a masked API key and its source
helpList available commands
quit / exitExit messygit

Typical flow

messygit > add .
Staged everything

messygit > commit
feat(cli): add interactive REPL with ASCII banner
Commit with this message? [y/n/e] y

messygit > push

Commit message style

The model follows Conventional Commits: type(scope): description

Allowed types: feat, fix, docs, style, refactor, test, chore. Subjects are one line, imperative, lowercase, no trailing period.

Publishing to PyPI

This project uses GitHub Actions with PyPI trusted publishing — no API tokens needed in your repo.

One-time setup

  1. Go to your project on pypi.org
  2. Add a Trusted Publisher:
    • Owner: your GitHub username
    • Repository: messygit
    • Workflow name: publish.yml
    • Environment: leave blank

To release a new version

  1. Bump version in pyproject.toml
  2. Commit and push
  3. Create a GitHub release:
git tag v0.2.0
git push origin v0.2.0
  1. Go to GitHub → Releases → Draft a new release → select the tag → Publish

The workflow at .github/workflows/publish.yml will automatically build and upload to PyPI.

Manual publish (without CI)

rm -rf dist/
python -m build
twine upload dist/*

License

MIT (see pyproject.toml).

Ver o original no GitHub

Bom para

Relacionados