◐ Shell
clean mode source ↗

GitHub - anjerodev/commitollama: AI Commits with ollama VS Extension.

A free alternative to Github Copilot's commit generator that runs on your device using Ollama.

Features

  • No telemetry or tracking.
  • No API key needed.
  • Use any model you have already pulled in Ollama.
  • No Internet connection needed.
  • Quick model switching from the Source Control toolbar or Command Palette.
  • Background pre-generation of change summaries for faster commits.

Demo

vscode-commitollama-demo

Requirements

  • Install Ollama on your local machine.
  • Pull at least one model, for example: ollama pull llama3.2
  • Make sure Ollama is running. Open http://127.0.0.1:11434/ in your browser (your port may differ), open the Ollama app, or run ollama serve.

Recommended models

These models work well for commit messages and are highlighted in the model picker:

llama3.2, codellama, qwen3, qwen2.5-coder:7b, mistral, gemma3, codegemma

See the Ollama library for more models.

Usage

  1. Stage your changes in Git.
  2. Run Commitollama from the Source Control title bar (sparkle icon).
  3. On first use, pick a model, then choose whether to save it in project settings (.vscode/settings.json) or user settings (all projects). The picker is skipped if commitollama.model is already set in either scope.
  4. The generated commit message is written to the commit input box.

Switching models

Use the swap icon next to the sparkle button in Source Control, or run Commitollama: Switch Model from the Command Palette. You can change the model and where it is saved at any time.

You can also set commitollama.model manually in VS Code settings.

Configuration

General

Setting Description Default
commitollama.model Ollama model tag (e.g. llama3.2:latest). Set via the model picker or manually. llama3.2:latest
commitollama.useEmojis Add emojis to commit messages. false
commitollama.useDescription Add a longer description below the subject line. false
commitollama.useLowerCase Lowercase the first letter of the commit message. false
commitollama.language Language preset (English, Spanish, Custom, …). English
commitollama.promptTemperature Model temperature (0–1). Higher = more creative. 0.2
commitollama.commitTemplate Final commit format. Placeholders: {{type}}, {{emoji}}, {{message}}. {{type}} {{emoji}}: {{message}}

Custom overrides

Setting Description
commitollama.custom.language Custom language. Used when commitollama.language is Custom.
commitollama.custom.emojis Map commit types to emojis. Only used when emojis are enabled.
commitollama.custom.endpoint Ollama server URL. Empty uses http://127.0.0.1:11434.
commitollama.custom.prompt Replace the default commit prompt entirely.
commitollama.custom.typeRules Custom rules for commit types.
commitollama.custom.commitMessageRules Custom rules for the commit subject.
commitollama.custom.descriptionPrompt Custom prompt for the commit description.
commitollama.custom.requestHeaders Extra HTTP headers for Ollama requests (e.g. auth).

Example emoji map:

"commitollama.custom.emojis": {
  "feat": "✨",
  "fix": "🐛",
  "docs": "📝",
  "style": "💎",
  "refactor": "♻️",
  "test": "🧪",
  "chore": "📦",
  "revert": "⏪"
}

Background generation

Summarizes file changes in the background while you work. When you commit, cached summaries are reused when possible, so generation is faster.

Setting Description Default
commitollama.background.enabled Enable background generation. true
commitollama.background.interval Seconds between periodic scans. 60
commitollama.background.onSave Summarize when a file is saved. true

Known Issues

  • Depending on the model, commit messages can be longer than ideal. They are meant as a starting point and can be edited before committing.
  • Some models do not support the structured JSON output Commitollama uses (for example certain reasoning or harmony-format models). If generation fails, switch to a recommended model via Commitollama: Switch Model. Error messages include the underlying Ollama response when available.

Contributing

  • Fork the repository and create a feature branch.
  • Install dependencies: pnpm install
  • Lint and format: pnpm run lint and pnpm run format-fix
  • Run tests: pnpm test
  • Build: pnpm run build (or pnpm run watch)
  • Follow the existing style and configuration (biome.json).
  • Open a PR against main with a clear description and meaningful commits (e.g. type(scope): message).