AI-Powered
Conventional Commits
Stop wasting brain power on commit messages. Generate semantic, high-quality conventional commits and markdown diff reports directly from your terminal.
- Added file selector logic
Engineered for Velocity
Eliminate Block
Never struggle to describe your changes again. Let AI generate professional commit messages instantly.
Standardize
Automatically enforced Conventional Commits format ensures a clean, readable project history.
Code Reviews
Generate "Diff Reports" that explain what changed and why it matters, before showing the raw code.
Safe by Default
Review every message before it lands, keep secrets out of commits, and get your staging area back if anything stops.
The Intelligence
Commit Flow
Experience the future of development. Selective staging, deep analysis, and instant perfection.
- Interactive file selection, from any folder in the repo
- Deep code analysis via Google Gemini
- Strict Conventional Commits formatting
- Review, edit, or regenerate before committing
- Secrets and build folders caught before they are committed
- One-step push with --push, including sign-in for private repos
# AI Diff Report
Implemented a robust JWT-based authentication system with secure token storage.
Markdown
Diff Reports
Capture your entire thought process in a structured document. Perfect for documentation, PR descriptions, and code reviews.
Non-Destructive
Analyze your changes without affecting your git stage or history.
AI Insight
Get concise, human-readable summaries for every modified file.
Built with high-performance tools
Get Your Gemini API Key
Git AIC uses Google Gemini for commit generation and diff explanations, so you will need a Gemini API key before setup.
Grab the key once, then continue into installation.
The fastest path is Google AI Studio. Create the key there, copy it, and then use the install instructions below to save it in Git AIC.
Open Google AI StudioKeep it private
Treat your Gemini API key like a password. Do not commit it to Git or expose it in client-side code.
Some users may need to create, import, or select a Google Cloud project in AI Studio before creating a key.
Step 1
Open AI Studio
Head to Google AI Studio to manage Gemini access and create API keys.
Step 2
Sign In to Google
Sign in, accept the current terms if prompted, then open the API key flow from AI Studio.
Step 3
Create or Reuse a Key
Generate a Gemini API key, or use the default project and key AI Studio may create for new users.
Step 4
Copy It Into Git AIC
Run git-aic set-key and paste the key when asked, or just run git aic: it asks for the key the first time. Keep it private.
Get Started in seconds
Path A: Global Install
NPM PACKAGE
Install:
Config Key:
Set Alias:
Run Now:
Path B: Local Clone
DEVELOPMENT
Clone & Install:
Environment:
Manual Alias:
Run Now:
Every command, one place
Options combine freely. git aic and git-aic are the same program once the alias is set up.
git aicPick files, let Gemini write the message, review it, and commit.
Review: Commit · Edit in your editor · Regenerate · Cancel
-p, --pushPush after committing.
Sets up origin, the upstream and sign-in when needed. With nothing new, pushes your unpushed commits.
-d, --diffWrite an AI-explained markdown report to git-diffs/ instead of committing.
Never stages or unstages anything.
-a, --allUse every changed file and skip the file selector.
-y, --yesSkip confirmations.
Commits without review, sets the upstream, pulls before pushing, and leaves out secret-looking files and un-ignored build folders.
--dry-runPrint the generated message without committing.
Your staging area is restored.
-v, --versionPrint the installed version.
-V and -version also work.
-h, --helpPrint help.
Use git aic -h or git aic help: Git reserves git aic --help for its manual pages.
git-aic set-key [key]Save your Gemini API key.
Leave out the key to be prompted, which keeps it out of your shell history.
git-aic set-model <model>Use another Gemini model, e.g. gemini-2.5-pro.
"default" goes back to gemini-2.5-flash.
git-aic set-branch-prompt <on|off>Offer to create a new branch before committing on main or master.
Off by default.
git-aic showShow the masked key and its source, the model, settings, and the config path.
git-aic aliasSet up the global git aic alias.
git-aic help [command]Help for git-aic or one command.
git aicPick files, review, commit
git aic -pCommit, then push
git aic -aCommit every changed file
git aic --dry-runPreview the message only
git aic -dDiff report for files you pick
git aic -d -aDiff report for every change
git aic -a -y -pNo prompts: commit everything and push (CI)
git-aic set-model gemini-2.5-proSwitch the Gemini model
GEMINI_COMMIT_MESSAGE_API_KEYGemini API key. Takes precedence over set-key.
GIT_AIC_MODELGemini model for this shell. Takes precedence over set-model.
GIT_AIC_DEBUG=1Print full error details.
- --push and --dry-run cannot be combined with --diff.
- Everything else combines freely, e.g. git aic -a -y -p.
- --yes never answers questions only you can: API key, Git name/email, remote URL, or credentials.