02 — How it works
install once → type aic → clean commit.
- 01 install brew install aic
- 02 setup provider · key · model — or your local agent
- 03 run type: aic
- 04 read reads the diff
- 05 draft writes the message
- 06 commit ships it ✓
03 — Auto-batching
below the file boundary
one file, many commits
Every other commit tool stops at the file boundary — one file, one message. aic reads your diff at the hunk level, so a single file touching three concerns becomes three focused, conventional commits. Nothing staged, one command, a history that actually reads back cleanly.
per-hunk batching ✦
see aic among the best AI commit tools →17 commit types · WCAG-safe colors
04 — Resolve
Resolve merge conflicts.
Mid-merge, run one command. aic reads every conflicted file, proposes a marker-free resolution, and shows you the combined diff before anything lands. Each file is a separate y/n — approve what you trust, reject the rest, and it finalizes the merge.
05 — Bring your agent
Bring your agent, not your key.
Already running Claude Code, Codex, Cursor, or Gemini? Point aic at your agent in headless mode — it passes the diff, your agent writes the message, aic ships the commit. No API key, no default model: it reuses your agent's own auth.
06 — Providers & privacy
your key · your model
Bring your own provider. aic talks straight to your LLM — no middleman, no per-commit markup, no proxy. Your API key never leaves your machine.
- OpenAI
- Anthropic
- Gemini
- DeepSeek
- Groq
- Ollama
- xAI
- Mistral
- OpenRouter
- Perplexity
- Together
- OpenAI-compatible
- OpenAI
- gpt-5-mini
- Anthropic
- claude-haiku-4-5
- Gemini
- gemini-2.5-flash
- DeepSeek
- deepseek-v4-flash
- Groq
- llama-3.3-70b-versatile
- Ollama
- llama3.3
- xAI
- grok-4.3
- Mistral
- mistral-small-latest
- OpenRouter
- (your model)
- Perplexity
- sonar
- Together
- meta-llama/Llama-3.3-70B-Instruct-Turbo
- OpenAI-compatible
- (your model)
no middleman · no per-commit markup · calls go straight from your machine
secrets redaction gate — secret-shaped content stops the run before it is sent
save profiles · switch with aic use
07 — Full control
steer it · review it · undo it
The model drafts; you stay in charge. A one-off hint steers the grouping, an opt-in batch review lets you merge or veto each plan before anything is drafted, and aic undo resets a whole run — commits gone, every change back unstaged.
- steer
aic --hint "keep the parser rewrite separate" - review
batch plan: merge · undo-merge · abort - undo
aic undo ✓ run reset, changes unstaged
how aic compares
Curious how aic holds up against aicommits, OpenCommit, or the rest? Each comparison concedes where the rival wins and shows exactly where aic pulls ahead.
see the full field →08 — Install
install aic in one line.
- Free & MIT
- No Node.js
- 12 providers
- Survives your pre-commit hooks
- Key never leaves your machine
- Secrets blocked before send
brew install CaicoLeung/aic/aic Update with `brew upgrade aic`. Homebrew installs are detected automatically, so `aic update` will redirect you to brew.
curl --proto '=https' --tlsv1.2 -sSfL https://github.com/CaicoLeung/aic/releases/latest/download/aic-installer.sh | sh Downloads the latest release binary from GitHub Releases.
irm https://github.com/CaicoLeung/aic/releases/latest/download/aic-installer.ps1 | iex PowerShell. Downloads the latest release binary.
then run aic setup to pick provider, key, and model.