Contributing

Thanks for considering a contribution!

Quick start

git clone https://github.com/cryptopecx/git-undo
cd git-undo
python -m venv .venv && source .venv/bin/activate
pip install -e . pytest ruff

ruff check .
ruff format --check .
pytest -q

All three must pass. CI runs them across Python 3.9 through 3.13.

Safety first. Anything destructive must back up its target ref to a branch before acting.
No new runtime dependencies. Standard library only.
Small surface area. New subcommands need a strong justification — the current four (undo, list, to, redo) cover most workflows.
Helpful output over magic. Always show the user the exact git operation we're about to perform, in their own terms.