commitwizard ✦

AI-powered git commit messages. Works with your Claude Code account — no API key needed.

Stage your changes, run commitwizard, and pick from smart suggestions following the Conventional Commits specification.

  ✦ commitwizard  ·  AI-powered git commit messages

  3 files  ·  +87  ·  -12

? Commit type:
❯ ✦ auto       AI decides based on the diff
  feat         — new feature
  fix          — bug fix
  refactor     — no behavior change
  …

? Ticket / issue (optional — Enter to skip): PROJ-123

  ╌╌╌ Suggestions ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
  
  1. feat(auth): add JWT refresh token rotation [PROJ-123]
  2. feat(auth): implement silent token renewal on expiry [PROJ-123]
  3. refactor(auth): extract token lifecycle into dedicated service [PROJ-123]

? Select a commit message: › …

Features

• Zero config — works out of the box if you have Claude Code installed
• Commit type selector — interactive menu to pick feat, fix, refactor… or let AI decide
• Ticket / issue linking — auto-detects Jira/Linear/GitHub issue numbers from your branch name, appends [PROJ-123] to the message
• Multiple suggestions — pick the best one, or regenerate
• Conventional Commits — feat, fix, docs, refactor, chore, and more
• Breaking change detection — automatically uses feat!: notation
• Gitmoji support — --emoji flag adds relevant emojis
• Multi-language — write commit messages in any language
• Style matching — reads recent commits to match your project's style
• Auto-commit mode — --yes for scripting and hooks
• Dry-run mode — preview without committing
• Clipboard copy — --copy sends the message to your clipboard
• Configurable model — Haiku (fast/cheap), Sonnet, or Opus

Install

npm install -g @gunesmuhammedorhun/commitwizard

Requirements

One of the following:

| Option | Setup | |---|---| | ✅ Claude Code installed | Nothing — just works | | 🔑 Anthropic API key | export ANTHROPIC_API_KEY=sk-ant-... |

Usage

git add .
commitwizard

Options

| Flag | Description | |---|---| | -y, --yes | Auto-commit with the top suggestion | | -e, --emoji | Add gitmoji to the description | | -l, --lang <lang> | Language: tr, de, fr, es… | | -m, --model <name> | haiku (default), sonnet, opus | | -n, --count <n> | Number of suggestions (default: 3) | | -t, --type <type> | Force a type: feat, fix, docs… (skips interactive selector) | | --ticket <id> | Ticket / issue reference to append: PROJ-123, #45 | | --dry-run | Generate without committing | | --copy | Copy selected message to clipboard | | --no-history | Skip recent commit history context |

Examples

# Interactive (default)
commitwizard

# Auto-commit the best suggestion
commitwizard --yes

# Use Sonnet for harder diffs
commitwizard --model sonnet

# Commit message in Turkish with emojis
commitwizard --lang tr --emoji

# Force fix type (skips type selector)
commitwizard --type fix

# Attach a Jira ticket manually
commitwizard --ticket PROJ-123

# Branch named feature/PROJ-456-login → ticket auto-detected
commitwizard

# Preview only
commitwizard --dry-run

Configuration

commitwizard config              # show current config
commitwizard config --set-model sonnet
commitwizard config --set-lang tr
commitwizard config --set-count 5
commitwizard config --toggle-emoji

Config is saved at ~/.config/ai-commit/config.json. Add .ai-commitrc.json to any project root for project-specific defaults.

Git hook

Auto-launch on every commit by adding to .git/hooks/prepare-commit-msg:

#!/bin/sh
exec < /dev/tty
commitwizard

Models

| Name | Model | Speed | Cost | |---|---|---|---| | haiku (default) | claude-haiku-4-5 | ⚡ Fast | $ Low | | sonnet | claude-sonnet-4-6 | ◈ Balanced | $$ Medium | | opus | claude-opus-4-7 | ◉ Best quality | $$$ Higher |

When using Claude Code (no API key), the model flag is ignored — Claude Code handles routing automatically.