GitMind
Autonomous Git commit intelligence for VS Code.
GitMind watches your workspace, understands your changes, and writes meaningful, grouped commits — automatically.
What it does
Most developers commit too late, too broadly, or with messages like "fix stuff". GitMind fixes that.
It runs a local AI agent in the background that continuously monitors your file changes, groups them by logical intent, and commits them with descriptive messages — without you having to think about it.
Features
Autonomous Commits
GitMind analyzes your staged and unstaged changes, groups them by feature or concern, and commits them with well-structured messages. No more "wip" or "misc fixes".
Context-Aware Grouping
Changes across multiple files are intelligently grouped. A refactor to an API handler and its corresponding test will be committed together — not separately.
⏱Scheduled & Triggered Modes
- Auto mode — commits run on a smart schedule based on your activity
- Manual trigger — hit Commit Now from the sidebar or command palette whenever you're ready
Optional Auto-Push
Enable gitmind.autoPushOnCommit to automatically push to origin after every commit — fully hands-free.
A dedicated sidebar panel shows you agent status, recent commits, and controls — all without leaving your editor.
Self-Healing Agent
The agent process automatically restarts on crash, with exponential backoff and a maximum retry limit to prevent runaway loops.
Requirements
- Python 3.9+ installed and available on your PATH
- GitMind will auto-detect your interpreter, including the one selected in the VS Code Python extension
- You can override with
gitmind.pythonPath in settings
- Git installed and a workspace with an initialized repo
- An API key for your chosen LLM provider (configured in the agent's
.env file)
Getting Started
- Install the extension
- Open a Git repository in VS Code
- GitMind will start automatically and install its Python dependencies in the background
- Watch the GitMind panel in the sidebar for status
On first launch, dependency installation may take 20–30 seconds. Subsequent starts are instant.
Extension Settings
| Setting |
Default |
Description |
gitmind.pythonPath |
"" |
Explicit path to a Python 3 binary. Leave empty to auto-detect. |
gitmind.agentDir |
"" |
Override path to the agent folder containing main.py. |
gitmind.autoStart |
true |
Automatically start the agent when VS Code opens. |
gitmind.autoPushOnCommit |
false |
Push to origin automatically after every auto-commit. |
Commands
All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
| Command |
Description |
GitMind: Start Agent |
Start the background agent |
GitMind: Stop Agent |
Stop the agent |
GitMind: Pause / Resume |
Temporarily pause auto-commits |
GitMind: Commit Now |
Trigger an immediate commit cycle |
GitMind: Push to Origin |
Push current branch to remote |
GitMind: Toggle Auto-Commit Mode |
Switch between auto and manual mode |
GitMind: Set Commit Tone |
Choose commit message style (conventional, casual, detailed) |
GitMind: Restart Agent |
Restart the Python agent process |
GitMind: Clear LLM Cache |
Clear the cached LLM responses |
GitMind: Reset Memory |
Reset the agent's persistent memory |
GitMind: Show Output Panel |
View raw agent logs |
How it works
Your file changes
↓
File watcher detects diffs
↓
Analyzer groups changes by intent
↓
LLM generates commit messages
↓
Planner schedules commits
↓
Git commits (and optionally pushes)
The agent runs as a local Python process and communicates with the extension over a local HTTP port. No data leaves your machine except to your configured LLM provider.
Known Issues
- Windows: Requires Python to be on the system PATH. The Microsoft Store version of Python may not work — use the installer from python.org.
- Large repos: The first analysis on a very large repo may take a few seconds longer than usual.
- Multiple workspaces: Each VS Code window runs its own agent instance on a separate port.
Release Notes
1.0.0
Initial release — autonomous commits, sidebar dashboard, auto-push support, self-healing agent process.
License
MIT © GitMind
