Smart Commit Generator AI

Fast, accurate, and context-aware Git assistant for VS Code, Cursor, and Antigravity IDE. Generate conventional commits, one-click commit & push, sync branches safely, draft comprehensive Pull Request descriptions, and resolve branch merge conflicts with OpenAI & Google Gemini.

Key Features

• Strict Diff Inspection: Reads your exact line additions and deletions—never assumes changes from file names or unrelated code.
• Conventional Commits: Produces standardized headers (feat, fix, refactor, perf, docs, chore, etc.) under 72 characters, with optional bullet points for multi-part edits.
• Fast Mode vs Safe Mode Toggle: Switch between instant 1-click push (zero dialogs) and safe review mode with a single click.
• Safe Branch Sync & Push ($(git-merge)): Automatically verifies zero merge conflicts in memory with git merge-tree before syncing and pushing changes to any target branch (e.g. publish, dev, staging).
• One-Click Commit & Push: Stage, generate, commit, and push to your remote repository in a single click with built-in preview and safety confirmation.
• Pull Request (PR) Generator: Compares your working branch against main or master to generate a comprehensive markdown PR description with summary, key changes, and verification checklist.
• Branch Compare & AI Conflict Advisor: Dry-run merge check between any two branches. Identifies conflicts before they happen and provides production-ready merged code solutions.
• Status Bar Launcher: Permanent $(sparkle) Smart Git status bar button displaying current mode with one-click access to all tools.
• Dual AI Engine: Seamlessly switch between OpenAI (gpt-4o-mini, gpt-4o) and Google Gemini (gemini-3.8-flash, gemini-2.5-pro).
• Interactive Setup: No manual configuration files required. If an API key is missing, a one-click prompt lets you paste your key directly in the editor.
• 100% Private & Local: Your API keys stay on your machine. API calls are made directly to OpenAI/Google with zero telemetry or intermediate servers.

Source Control Toolbar Actions

Six dedicated action buttons are built right into your Source Control view header:

#	Button	Action	Shortcut	Description
1		Generate Message	Ctrl+Alt+G	Inspects staged diff and populates the commit box with Conventional Commits.
2		Generate, Commit & Push	Ctrl+Alt+P	Stages modified files, generates message, commits, and pushes to remote in 1 click.
3		Safe Sync to Branch	Ctrl+Alt+S	Conflict-safe branch merge & push with auto semver release bump (e.g. main ➔ publish).
4		Generate PR Description	—	Drafts full markdown Pull Request description and copies to clipboard.
5		Compare & Security Audit	Ctrl+Alt+C	Compares branches, checks conflicts, scans for leaked API keys, and offers 1-click push.
6		Toggle Fast / Safe Mode	Ctrl+Alt+T	Flips visually between Safe Mode (modal confirmation) and Fast Mode (instant push).

Detailed Workflows

1. Generating a Commit Message

1. Open the Source Control panel (Ctrl + Shift + G).
2. Stage your changes (+), or leave them unstaged—the extension checks unstaged diffs as fallback.
3. Click the sparkle icon ($(sparkle)) on your repository header or press Ctrl + Alt + G.
4. Your commit message will appear in the commit input box instantly.

2. One-Click Commit & Push

1. Click the cloud upload icon ($(cloud-upload)) or press Ctrl + Alt + P.
2. In Safe Mode: A modal dialog previews the message and lets you confirm.
3. In Fast Mode: Immediately stages, commits, and pushes to remote with zero dialogs.

3. Safe Branch Sync & Push

1. Click the safe branch sync icon ($(git-merge)) or press Ctrl + Alt + S.
2. Select your target branch (e.g., publish to release, or staging).
3. The extension tests for merge conflicts in memory:
   • Zero conflicts: Safely switches, merges, pushes to remote, and returns to your working branch.
   • Conflicts detected: Aborts before touching files and opens the AI Conflict Advisor.

4. Pull Request Description Generator

1. Click the git pull request icon ($(git-pull-request)).
2. The AI compares your working branch against main or master.
3. Copies full Markdown PR to your clipboard and opens in a new tab.

5. Branch Compare, Security Audit & Direct Push

1. Click the branch compare icon ($(diff)) or press Ctrl + Alt + C.
2. Select any target branch to compare against.
3. Automatically runs:
   • Merge conflict dry-run (git merge-tree).
   • Security scanner for leaked credentials, API keys, or private tokens.
   • AI Architecture & Risk report opened in your editor.
4. If clean and ready, provides direct 1-click modal actions:
   • Sync & Push to "<branch>": Automatically merges and pushes right from the comparison!
   • Generate PR Description: Formats ready-to-paste PR markdown.
   • Cancel: Closes modal and keeps report open.
5. If conflicts exist, blocks pushing and provides step-by-step resolution guidance.

Configuration

Open Settings (Ctrl + ,) and search for smartCommit:

Keyboard Shortcuts

License

MIT © Hessam Barasm Mamagani