/CommitSage

Commit Sage is a VSCode extension that automatically generates commit messages

Primary LanguageTypeScriptMIT LicenseMIT

Commit Sage (formerly GeminiCommit)

Visual Studio Marketplace Version Visual Studio Marketplace Last Updated Visual Studio Marketplace Installs Visual Studio Marketplace Rating

Commit Sage is a VSCode extension that automatically generates commit messages using various AI providers:

  • Gemini (default, requires API key, free)
  • OpenAI (requires API key or compatible provider)
  • Codestral (requires API key, free)
  • Ollama (local, free)

Commit Sage in action

Features

  • 🤖 AI-powered commit message generation
  • 🌍 Multiple language support (English, Russian, Chinese, Japanese)
  • 📝 Various commit formats (Conventional, Angular, Karma, Semantic, Emoji, EmojiKarma)
  • 🔄 Smart handling of staged/unstaged changes
  • 🚀 Auto-commit and auto-push capabilities
  • 🎯 Custom instructions support
  • ⚡ Fast and efficient processing

Configuration

Get your API key:

AI Provider Settings

  • Provider Selection (commitSage.provider.type):

    • Choose between: gemini, openai, codestral, ollama
    • Default: gemini

  • Gemini Settings:

    • Model (commitSage.gemini.model):
      • Options: gemini-1.0-pro, gemini-1.5-pro, gemini-1.5-flash, gemini-2.0-flash-exp
      • Default: gemini-1.5-flash

  • OpenAI Settings:

    • Model (commitSage.openai.model): Default gpt-3.5-turbo
    • Base URL (commitSage.openai.baseUrl): For custom endpoints/Azure

  • Codestral Settings:

    • Model (commitSage.codestral.model):
      • Options: codestral-2405, codestral-latest
      • Default: codestral-latest

  • Ollama Settings:

    • Base URL (commitSage.ollama.baseUrl): Default http://localhost:11434
    • Model (commitSage.ollama.model): Default llama3.2

Commit Settings

  • Language (commitSage.commit.commitLanguage):

    • Options: english, russian, chinese, japanese
    • Default: english

  • Format (commitSage.commit.commitFormat):

    • Options: conventional, angular, karma, semantic, emoji, emojiKarma
    • Default: conventional

  • Staged Changes (commitSage.commit.onlyStagedChanges):

    • When enabled: Only analyzes staged changes
    • When disabled:
      • Uses staged changes if present
      • Uses all changes if no staged changes
    • Default: false

  • Auto Commit (commitSage.commit.autoCommit):

    • Automatically commits after message generation
    • Default: false

  • Auto Push (commitSage.commit.autoPush):

    • Automatically pushes after auto-commit
    • Requires Auto Commit to be enabled
    • Default: false

  • References (commitSage.commit.promptForRefs):

    • Prompts for issue/PR references
    • Default: false

Custom Instructions

  • Enable (commitSage.commit.useCustomInstructions):

    • Default: false

  • Instructions (commitSage.commit.customInstructions):

    • Custom prompt instructions
    • Used when enabled

Telemetry

  • Enable (commitSage.telemetry.enabled):
    • Collects anonymous usage data
    • Default: true

Usage

  1. Stage your changes in Git
  2. Press Cmd+G (Mac) / Ctrl+G (Windows/Linux)
  3. Or click the Commit Sage icon in the Source Control view
  4. Wait for the AI to analyze changes and generate a message
  5. Review and edit the message if needed
  6. Commit as usual

Requirements

  • VSCode 1.93.0 or higher
  • Git installed and configured
  • Internet connection (except for Ollama)
  • API key for OpenAI/Codestral (if using those providers)

License

MIT

Support

If you encounter any issues or have suggestions, please open an issue.

Commit Sage (на русском)

Commit Sage - расширение VSCode для автоматической генерации сообщений коммитов с использованием Gemini AI от Google, Codestral API или OpenAI API (OpenAI, Ollama, LocalAI и другие).

Установка

  1. Установите из VS Code Marketplace
  2. Получите API ключ:
    • Для Gemini: Google AI Studio
    • Для Codestral: Mistral AI Console
    • Для других: Используйте ключ от OpenAI или другого совместимого сервиса
  3. Настройте ключ в VS Code:
    • Откройте палитру команд (Ctrl+Shift+P / Cmd+Shift+P)
    • Введите "Commit Sage: Set Gemini API Key", "Commit Sage: Set Codestral API Key" или "Commit Sage: Set Custom API Key"
    • Введите ваш API ключ

Использование

  1. Добавьте изменения в Git (git add)
  2. Откройте палитру команд (Ctrl+Shift+P / Cmd+Shift+P)
  3. Введите "Commit Sage: Generate Commit Message"
  4. Проверьте и подтвердите сгенерированное сообщение

Настройка

Все настройки доступны через:

  • Палитра команд → "Preferences: Open Settings (UI)"
  • Поиск "Commit Sage"

Поддержка