commitcraft

Auto-generate meaningful git commit messages from your staged diff using AI (Claude or Gemini).

npx commitcraft init

---

Install

npm install -g @syedfahadandrabi/commitcraft

Or use without installing:

npx commitcraft gen

---

Setup

Configure your API keys:

commitcraft setup

Or set them manually:

# Claude (Anthropic) — recommended, best quality
commitcraft config set ANTHROPIC_API_KEY "sk-ant-..."

# Gemini (Google) — free tier available
commitcraft config set GEMINI_API_KEY "AIza..."

Keys are stored securely in ~/.config/commitcraft/keys.json. Environment variables take precedence over stored keys.

---

Usage

Install the git hook (recommended)

Works automatically on every git commit:

cd your-project
commitcraft init

Now just stage your changes and commit as usual:

git add .
git commit   # ← message is auto-generated

Generate and commit in one step

Bypasses the editor entirely:

git add .
commitcraft commit

Dry run (preview without committing)

commitcraft gen

With a hint

commitcraft gen --hint "fixing the broken login redirect"

With a commit body (verbose)

commitcraft gen --verbose

Force a provider

commitcraft gen --provider claude
commitcraft gen --provider gemini

Manage API keys

commitcraft config list              # Show stored keys (masked)
commitcraft config delete GEMINI_API_KEY   # Remove a key

Uninstall hook

commitcraft uninstall

---

Example output

feat(auth): add JWT refresh token rotation

- Replace single-use tokens with rotating refresh token strategy
- Store token family in Redis to detect reuse attacks
- Invalidate entire family on suspicious reuse detection

---

Commands

Command	Description
commitcraft init	Install git hook in current repo
commitcraft uninstall	Remove git hook from current repo
commitcraft commit	Generate message and commit directly
commitcraft gen	Generate a commit message (dry run)
commitcraft setup	Interactive API key setup
commitcraft config	Manage stored API keys (set/list/delete)

Options for gen and commit

Flag	Description
--hint <text>	Give the AI a hint about what you changed
--verbose	Include a commit body with bullet points
--provider <name>	Force provider: claude or gemini

---

How it works

1. commitcraft init installs a prepare-commit-msg git hook in your repo
2. On every git commit, git runs the hook automatically
3. The hook calls commitcraft gen --write, which:
   • Runs git diff --cached to get your staged changes
   • Sends the diff to AI (Claude Haiku or Gemini Flash)
   • Writes the generated message to your commit file
4. Your editor opens pre-filled — edit or accept and save

Provider auto-detection

If no --provider flag is given, commitcraft picks the first available:

1. ANTHROPIC_API_KEY → Claude
2. GEMINI_API_KEY → Gemini

---

Development

npm install
npm run build    # Compile TypeScript
npm test         # Run tests

---

License

MIT