CommitCraft

CommitCraft is a VS Code extension that turns your staged Git diff into a polished conventional commit message, branch name ideas, and practical next-step suggestions.

CommitCraft hero demo placeholder

Prerequisites

Git installed and available on your system path
VS Code 1.85 or newer

No API key required. CommitCraft works immediately after install with up to 10 free AI-powered generations per day via the CommitCraft hosted backend. Add your own Gemini API key later from Google AI Studio for unlimited direct access.

Quick Start

Install the extension and open a Git repository in VS Code.
Stage changes with git add, then run CommitCraft: Generate Commit Message.
Optional: run CommitCraft: Configure to add a Gemini API key or choose a model.

How It Works

Without an API key (default)

When you haven't configured an API key, CommitCraft sends your diff and repository context to the CommitCraft hosted backend — a lightweight Cloudflare Worker that calls Gemini on your behalf. You get up to 10 free AI-powered generations per day. After the daily limit, you'll be prompted to add your own API key or wait until tomorrow.

Your developer Gemini API key is stored only on the backend server as an encrypted environment secret. It is never bundled in the extension, placed in package.json, or exposed in client-side code.
An anonymous install ID (a random UUID) is generated and stored locally to track your daily usage. It contains no personal information.

With your own API key

After adding a Gemini API key via CommitCraft: Configure, the extension calls Google's Gemini API directly — bypassing the hosted backend entirely. There is no daily limit when using your own key.

Your API key is stored securely in VS Code SecretStorage (OS-level credential storage).
You can update or remove your key at any time via CommitCraft: Configure.

Features

AI-generated commit messages

CommitCraft analyzes your staged diff, recent commit history, and current branch to draft a conventional commit message plus a short supporting description.

Commit generation output

The sidebar keeps commit generation, branch ideas, next steps, staging actions, and commit execution together in one place.

Sidebar workflow

Secure configuration flow

Optionally configure your Gemini API key securely, switch models, and reset settings without editing JSON by hand.

Configuration flow

Branch suggestions and next steps

Suggests a primary branch name and backup alternatives
Recommends useful follow-up tasks like tests, docs, refactors, and security checks
Streams commit output as it arrives so you can review it immediately
Handles transient Gemini failures with retries and clearer quota/auth guidance

Configuration

Setting	Type	Default	Description
`commitcraft.geminiApiKey`	`string`	`""`	Deprecated plaintext setting kept only for migration to SecretStorage. Use `CommitCraft: Configure` instead.
`commitcraft.model`	`string`	`gemini-2.5-flash`	Gemini model used for generation.
`commitcraft.conventionalCommitTypes`	`string[]`	`["feat","fix","chore","refactor","docs","test","perf","ci","build"]`	Allowed commit prefixes CommitCraft can suggest.
`commitcraft.maxDiffLength`	`number`	`12000`	Maximum number of diff characters used for generation after chunking.
`commitcraft.autoStageAll`	`boolean`	`false`	Stage all modified files before generating output.
`commitcraft.debugMode`	`boolean`	`false`	Enables verbose logging in the CommitCraft Logs output channel.

FAQ

Is my code sent anywhere?

Without an API key, CommitCraft sends your prepared Git diff and lightweight repository context (repo name, branch, recent commits) to the CommitCraft hosted backend — a Cloudflare Worker that calls Google's Gemini API on your behalf. No other data is collected. After you add your own Gemini API key, the extension calls Gemini directly and the backend is bypassed entirely. Telemetry stays opt-in through VS Code's built-in telemetry controls.

Where is my API key stored?

Your Gemini API key is stored in VS Code SecretStorage (OS-level credential storage) after you configure it. The developer's Gemini API key used by the free tier lives only on the hosted backend as an encrypted server secret — it is never included in the extension source, package, or bundled JavaScript.

What is the daily free limit?

You get 10 free AI-powered generations per day without adding your own API key. This limit resets daily. After 10 generations, you'll be prompted to add your own Gemini API key for unlimited use, or try again tomorrow.

What happens if Gemini is slow or unavailable?

CommitCraft retries transient network and 503 failures with exponential backoff, and it surfaces clearer messages for quota and authentication problems.

Contributing

Contributions are welcome.

Fork the repository and create a feature branch.
Install dependencies with npm install.
Run npm run check before opening a pull request.
Use F5 in VS Code to launch an Extension Development Host for local testing.

Issues, feature requests, and bug reports belong in the GitHub issue tracker.

CommitCraft Pro

Simon Emmanuel