AI-powered git commit message generator for VS Code. Click the sparkle icon (✨) in the Source Control panel to instantly generate a commit message from your staged diff.
- One-click commit messages from your staged or unstaged diff
- Multiple AI backends — GitHub Copilot, Claude CLI, Perplexity, or any VS Code LM provider
- Conventional Commits format with your recent commits as style reference
- Commitlint-aware — reads your project's commitlint config and follows your rules
- Respects VS Code git settings for subject and body line length limits
Depending on your chosen method:
auto/vscode-lm— a VS Code language model provider such as GitHub Copilotclaude-cli— theclaudeCLI installed and available on yourPATHperplexity— a Perplexity API key (set via the command Git Commit: Store Perplexity API Key)
| Setting | Default | Description |
|---|---|---|
ranCommit.method |
auto |
Generation method: auto, vscode-lm, claude-cli, or perplexity |
ranCommit.claudeCliModel |
(default) | Model alias for claude-cli (e.g. sonnet, opus, haiku). See model config docs. |
ranCommit.perplexityModel |
(default) | Perplexity Agent API model (e.g. perplexity/sonar). See Perplexity models. |
ranCommit.vscodeLmModel |
(default) | Model for vscode-lm / auto. Format: vendor/family (e.g. copilot/gpt-4o). |
Use the Ran - AI Conventional Commit: Select Model command to pick a model interactively.
- Stage your changes in the Source Control panel (or leave them unstaged — the extension will use the full diff as a fallback).
- Click the ✨ sparkle icon in the SCM title bar.
- The generated commit message is inserted into the commit message box, ready to edit or submit.