acai

AI-generated commit messages that match your repo's existing style. Powered by Claude Code or Codex.

acai reads your repo's recent commit history and adapts to whatever conventions your team already uses — conventional commits, gitmoji, ticket prefixes, pig latin, etc.

[!NOTE] I vibed this up in a day based on my own needs and desires, but am more than willing to accept feedback and PRs!

How it works

1. Reads the last ~10 commits from your repo's git log
2. Reads your staged diff
3. Sends both to your chosen AI provider, asking it to analyze the repo's commit style and generate a message that matches
4. Presents the message for your approval — you can accept, edit, revise with feedback, regenerate, or copy to clipboard

Prerequisites

• Node.js runtime
• At least one of the following CLIs installed and signed in:

| Provider | Install | |----------|---------| | Claude Code (default) | curl -fsSL https://claude.ai/install.sh \| bash | | Codex | npm i -g @openai/codex |

Options

| Flag | Env var | Default | Description | |------|---------|---------|-------------| | -p, --provider | ACAI_PROVIDER | claude | AI provider (claude, codex) | | -m, --model | ACAI_MODEL | provider default | Model override (sonnet, gpt-5.3-codex, etc.) | | -y, --yolo | — | false | Stage all changes and commit without confirmation |

Usage

From any git repo with staged (or unstaged) changes:

# Run directly with npx (no install needed)
npx @jakejarvis/acai@latest

# Or install globally
npm install -g @jakejarvis/acai
acai

# Use a different provider
acai -p codex

# Override the model
acai -m haiku
acai -p codex -m o4-mini

# Stage everything, generate, and commit — no prompts
acai --yolo

The flow

┌  acai
│
◇  3 files staged
│
◆  Generating commit message…
│
│  feat(auth): add session expiry validation
│
◆  What do you want to do?
│  ✓ Commit          — accept and commit
│  ✎ Edit            — open in $EDITOR before committing
│  ↻ Revise          — give Claude feedback and regenerate
│  ⎘ Copy            — copy to clipboard, don't commit
│  ✕ Cancel
│
└  Done.

Revision loop

Choose Revise and tell Claude what to change:

◆  What should Claude change?
│  make it shorter, drop the scope
│
◆  Generating commit message…
│
│  feat: add session expiry validation

You can revise as many times as you like before committing.

YOLO mode

Just want to commit and move on? acai --yolo stages all changes, generates a message, and commits — zero interaction required.

No staged changes?

If nothing is staged, the tool will offer to git add -A for you.

How style detection works

There's no manual configuration or pattern matching. The tool passes your recent commit log directly to the AI and asks it to infer the conventions. It picks up on:

• Format — conventional commits, gitmoji, [tag] prefixes, ticket IDs, freeform
• Tone — imperative mood vs past tense, formal vs casual
• Capitalization — uppercase vs lowercase subjects
• Scope — whether (scope) is used in conventional commits
• Body — whether commits typically include a body or are subject-only
• Detail level — terse one-liners vs detailed descriptions

New repo with no history? It defaults to clean, concise conventional commits.

License

MIT