Commitollama 🦙

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

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).