ez-commit

A lightweight Go CLI that uses Claude to analyze your uncommitted git changes and automatically execute a series of logical, atomic commits with Conventional Commit messages.

How it works

1. Runs git diff -U0 to capture all uncommitted changes
2. Sends the diff to Claude with a strict JSON-only system prompt
3. Claude returns a structured array of CommitTask objects — each a logical atomic commit
4. You confirm (or skip) each proposed commit interactively
5. ez-commit stages the relevant files and commits them one by one

Installation

go install github.com/tolgazorlu/ez-commit@latest

Or build from source:

git clone https://github.com/tolgazorlu/ez-commit
cd ez-commit
go build -o ez-commit .

Usage

# Preview proposed commits without committing anything
ez-commit --dry-run
# Interactive mode: confirm each commit before it's applied
ez-commit

Requirements

Set your Anthropic API key:

export ANTHROPIC_API_KEY=sk-ant-...

Example output

Found 3 hunk(s). Consulting Claude...
Claude proposed 2 commit(s):
─────────────────────────────────────────
Commit 1 / 2
Message : feat: add user authentication handler
Rationale: Auth logic is independent from the API refactor
Files :
internal/auth/handler.go
Hunks : 2 hunk(s)
Stage and commit this? [Y/n]:
✓ Committed: feat: add user authentication handler
─────────────────────────────────────────
Commit 2 / 2
Message : refactor: extract database query helpers
Rationale: DB helper extraction is a separate concern from auth
Files :
internal/db/queries.go
Hunks : 1 hunk(s)
Stage and commit this? [Y/n]:
✓ Committed: refactor: extract database query helpers
Done.