🧠 Gitgeist AI - VS Code Extension
Standalone AI-powered Git commit generation with native VS Code panels
Generate intelligent commit messages using local LLMs with semantic code analysis. No CLI dependencies required - everything runs directly in VS Code!
✨ Features
- 🤖 Native AI Panels: Dedicated VS Code panels for commit generation and analysis
- ⚡ One-Click Commits: Generate and commit with a single button
- 🔍 Real-Time Analysis: Live code change analysis with visual stats
- 🔒 100% Local: Uses local Ollama LLMs - no data sent to cloud
- 🎯 Smart Integration: Status bar indicators and activity bar section
- 🧠 Semantic Analysis: Understands functions, classes, and code structure
📋 Requirements
Only 2 things needed:
- Ollama running with a model
- Git repository in your workspace
# Install and start Ollama
curl -fsSL https://ollama.ai/install.sh | sh
ollama pull llama3.2
ollama serve
🚀 Quick Start
- Install the extension from VS Code Marketplace
- Open a Git repository in VS Code
- Make changes to your code
- Click the Gitgeist AI icon in the Activity Bar
- Generate commit message in the native panel
- Review and commit with one click!
🎛️ Native Panels
Commit Generator Panel
- Generate AI commit messages
- Preview and edit messages
- One-click commit or copy to clipboard
- Real-time Ollama status
Code Analysis Panel
- Live change statistics
- File type breakdown
- Semantic change detection
- Auto-refresh on file save
⚙️ Configuration
Access via File > Preferences > Settings → search "Gitgeist":
gitgeist.ollamaHost: Ollama server URL (default: http://localhost:11434)gitgeist.model: LLM model to use (default: llama3.2)gitgeist.commitStyle: Message style (conventional, semantic, default)gitgeist.autoAnalyze: Auto-analyze on file save (default: true)gitgeist.showStatusBar: Show status bar item (default: true)
🎯 Usage
Method 1: Native Panels (Recommended)
- Click Gitgeist AI in Activity Bar
- Use Commit Generator panel
- Click "Generate Commit Message"
- Review, edit, and commit
Method 2: Command Palette
Ctrl+Shift+P → "Gitgeist: Generate AI Commit Message"Ctrl+Shift+P → "Gitgeist: Quick AI Commit"Ctrl+Shift+P → "Gitgeist: Analyze Changes"
Method 3: Status Bar
- Click the 🤖 Gitgeist AI status bar item
- Opens commit panel directly
🔧 Troubleshooting
"Ollama offline" in status bar
- Start Ollama:
ollama serve
- Check model is available:
ollama list
"No changes detected"
- Make sure you have uncommitted changes
- Check you're in a Git repository
Extension not loading
- Reload VS Code window
- Check VS Code version >= 1.74.0
🆚 What's Different
Old CLI-based approach:
- Required
pip install gitgeist
- Terminal commands
- External dependencies
New standalone extension:
- ✅ No CLI installation needed
- ✅ Native VS Code panels
- ✅ Direct Ollama integration
- ✅ Real-time status monitoring
- ✅ Works for all programming languages
🔒 Privacy & Security
- 100% Local Processing: All analysis on your machine
- No Cloud Dependencies: Uses local Ollama only
- No Data Collection: Code never leaves your computer
- Open Source: Full transparency
📊 Supported Languages
JavaScript, TypeScript, Python, Java, Go, Rust, C/C++, C#, PHP, Ruby, Swift, Kotlin, Scala, and more!
🤝 Support
Made with ❤️ for developers who love clean commits
