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
save profiles · switch with aic use
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 →07 — Install
install aic in one line.
- Free & MIT
- No Node.js
- 12 providers
- Survives your pre-commit hooks
- Key never leaves your machine
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.