Feature release adding diff review, commit history, message rewriting, and smarter scope detection.

aic review — Diff Review

A new review subcommand analyses your staged diff for bugs, security issues, performance concerns, and style problems. Findings are grouped by severity and rendered with terminal formatting.

aic review
aic review -c "focus on security"
aic review -c "this is a database migration"

• Findings are categorised as Critical, Warning, or Suggestion.
• Large diffs are automatically chunked and synthesised into a single review.
• If no files are staged, aic review offers to stage them interactively — the same flow as the commit command.
• Review output is rendered with styled terminal formatting (bold, headers, code blocks) via termimad, replacing raw markdown.

The review prompt lives in prompts/review-system.md and follows the same template convention as the commit prompt.

aic history — Commit and Review History

Every generated commit message and review is now saved to ~/.aicommit-history.json. Browse recent entries with the new history subcommand.

aic history
aic history -n 5
aic history --kind commit
aic history --kind review

Each entry records the timestamp, kind (commit or review), message content, repository path, files involved, and the provider/model used.

aic log — Rewrite Commit Messages

Clean up the last N commit messages on your branch using AI before opening a PR.

aic log
aic log -n 3
aic log -n 5 --yes

• Generates new messages for each commit using the same AI provider as normal commits.
• Shows a before/after comparison and rewrites via git rebase on confirmation.
• Requires a clean working tree and no merge commits in the range.
• Designed for local branch cleanup before pushing — do not use on shared branches.

Conventional Commit Scope Hints

aic now analyses staged file paths and suggests likely scopes to the AI. For example, changes to src/ai/ hint at the scope ai, Cargo.toml hints at deps, and src/commands/ hints at cli.

• Scope hints appear in the system prompt only when AIC_OMIT_SCOPE is not set.
• Up to five scopes are suggested, derived from a curated mapping of well-known directories and filenames.
• The AI still decides the final scope — hints improve consistency without forcing a choice.

Other Changes

• Error messages — the "empty commit message" error is now "empty response", which reads correctly for both commit and review contexts.
• README — rewritten with a quick start guide, flags table, feature list, and clearer structure.
• CI — docs-only changes no longer trigger build workflows; artifact download actions refreshed.

Install

macOS users can install with Homebrew:

brew install russmckendrick/tap/aicommit

Pre-built binaries are published for Linux, macOS, and Windows from GitHub Releases. The installed executable is aic.

Notes

• The review command reuses the existing AiEngine provider infrastructure, so it works with OpenAI, Azure OpenAI, and any compatible endpoint.
• Scope hints use a curated allowlist of directory-to-scope mappings. Unknown file paths are silently ignored rather than generating arbitrary scopes.
• History is recorded after successful commits and reviews. Hook-generated commits are not recorded because the hook runs before the commit is finalised.
• aic log rewrites history via git rebase — it will abort cleanly if conflicts or merge commits are encountered.
• All existing flags, configuration, and provider behavior remain the same.

Full Changelog: https://github.com/russmckendrick/aicommit/compare/v0.0.2...v0.0.3

Full Changelog: https://github.com/russmckendrick/aicommit/compare/v0.0.2...v0.0.3