Skip to content

VizzleTF/CommitSage

Repository files navigation

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)
  • 🔄 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
    • 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"

Поддержка