Git Gud — Competitive Git Extension
Gamify your Git workflow with esports-style roasts and rankings.
Features
- Real-time Git monitoring — Watches your commits, pushes, merges, and more
- Esports-style roasts — Get roasted for bad Git habits (60+ templates + AI-powered)
- Rank ladder — Bronze Committer → Diamond Git Wizard
- 20+ Achievements — Unlock badges like "Force Push Felon" and "Merge Conflict Survivor"
- Personality classifier — Discover if you're a Commit Goblin, Chaos Mage, or Perfectionist
- Team leaderboard — Share stats with your team and compete weekly
- Sound effects — Meme-worthy audio feedback for your Git crimes
- AI roast generation — Ollama (local) or Gemini API for custom roasts
Quick Start
- Install the extension from VS Code Marketplace
- Open the Git Gud sidebar from the Activity Bar
- Start coding — the extension activates automatically when it detects a
.git folder
- Make a commit and get roasted!
Commands
| Command |
Description |
Git Gud: Show Dashboard |
Open the sidebar |
Git Gud: Reset Stats |
Wipe all progress |
Git Gud: Set API Key |
Configure AI provider key |
Git Gud: Run Demo |
Demo a roast notification |
Git Gud: Export Rank Card |
Save rank card as SVG |
Git Gud: Weekly Hygiene Report |
View weekly report |
Git Gud: Share Stats to Team |
Sync stats to team leaderboard |
Settings
gitgud.enabled — Enable/disable monitoringgitgud.roastIntensity — mild / medium / savagegitgud.notificationsEnabled — Show notification popupsgitgud.aiProvider — ollama / geminigitgud.ollamaApiKey — API key for Ollamagitgud.ollamaModel — Ollama model namegitgud.ollamaBaseUrl — Ollama API base URLgitgud.geminiApiKey — Gemini API keygitgud.voiceEnabled — Speak roasts out loudgitgud.teamCode — Team code for shared leaderboardgitgud.syncUrl — URL to sync stats to web leaderboard
Team Features
Share your Git crimes with the world:
- Set your team code in settings
- Run "Share Stats to Team" command after a session
- View your team leaderboard at the web companion
License
MIT — HackMelbourne Trend Hackers
| |
