AI Conventional Commit Crafter ✨

Instantly craft standardized Conventional Commit messages (feat:, fix:, docs:, chore:) from your git diff with 1 click using AI or the offline Smart Heuristic Engine!
Save time and enforce pristine repository history across your entire engineering team.

✨ Why Commit Crafter?

Engineering teams worldwide enforce the Conventional Commits 1.0.0 specification for automated semantic versioning, changelog generation, and clean git history. But manually writing descriptive messages like feat(auth): implement refresh token validation after editing multiple files is slow and repetitive.

Commit Crafter adds an intelligent commit generator directly into the VS Code Source Control (Git) interface:

• 🪄 1-Click Generation: Click the sparkle ✨ button in the Source Control panel or press Alt + Shift + C to analyze changes and populate the commit message instantly.
• ⚡ Zero-Setup Offline Engine: Generates accurate Conventional Commit messages out of the box using built-in AST and git diff heuristics — no API key or internet required!
• 🤖 Optional Multi-AI Support: Connect your free Gemini API key, OpenAI, Groq, or run completely private local LLMs via Ollama.
• 📋 Interactive Builder: Guided step-by-step wizard to pick types (feat, fix, docs, style, refactor, perf, test, build, ci, chore), scopes, and descriptions.
• 🎨 Optional Gitmoji: Toggle standard Git emojis (✨ feat, 🐛 fix, 📝 docs, ♻️ refactor).

🌟 Key Features

1. ⚡ Offline Smart Heuristic Engine (Default)

Commit Crafter analyzes your staged files, modified symbols, file extensions, and diff context:

• Adding new functions or components ➔ feat(scope): implement component and related functionality
• Editing tests (*.test.ts, *.spec.py) ➔ test(scope): add automated unit and integration tests
• Editing documentation (*.md, docs/) ➔ docs(readme): update documentation in README.md
• Updating dependencies (package.json, lockfiles) ➔ chore(deps): update project configuration and dependencies
• Resolving errors, exceptions, or bugfix blocks ➔ fix(scope): resolve issue in service

2. 🤖 Connect AI Models for Deep Understanding

If you want deep contextual summaries, select your favorite AI provider in VS Code settings:

• Google Gemini (Free tier supported via Gemini 1.5 Flash)
• OpenAI (GPT-4o, GPT-4o-mini)
• Groq (Ultra-fast Llama-3.1-8b-instant)
• Ollama (100% private local models like llama3.2)

3. 🎯 Direct Source Control Panel Integration

A glowing ✨ magic button appears directly in your VS Code Source Control header bar. One click inspects your staged changes and types the commit message for you.

⌨️ Keyboard Shortcuts & Commands

⚙️ Configuration

Customize Commit Crafter in VS Code Settings (Ctrl + , / Cmd + ,):

{
  // Engine: "heuristic" (offline default) | "gemini" | "openai" | "groq" | "ollama"
  "commitCrafter.aiProvider": "heuristic",

  // API Key for your selected cloud AI provider
  "commitCrafter.apiKey": "",

  // Custom model override (optional)
  "commitCrafter.model": "",

  // Automatically detect and append scope: feat(scope): message
  "commitCrafter.includeScope": true,

  // Prepend Gitmoji: ✨ feat: ..., 🐛 fix: ...
  "commitCrafter.includeEmoji": false
}

👨‍💻 Author & Connect

Developed with ❤️ by Pirapaakaran Pirathapan.

• 💼 LinkedIn: pirapaakaran-pirathapan
• 🌐 Facebook: pirapaakaranpirathapan

If you find this extension helpful, please consider leaving a ⭐⭐⭐⭐⭐ review on the VS Code Marketplace!

📄 License

MIT License © 2026 Pirapaakaran Pirathapan.