🎭 CodeBuddy — Your Annoying Coding Avatar
An animated cartoon character that lives in VS Code and makes your coding life 10% more chaotic.
What is CodeBuddy?
CodeBuddy is a fully animated CSS sprite character that watches you code and interrupts you at the worst possible moments. It:
- 😤 Reacts to your bugs — calls you out every time an error appears
- 💤 Detects when you go idle — wakes you up if you stop typing
- ⏱️ Tracks long sessions — reminds you that humans need breaks
- 🎲 Randomly appears — just to make sure you haven't gone insane
- 🏆 Tracks your stats — 12 achievements, error streaks, session history
- 🔊 Makes sounds — unique Web Audio sounds for every mood
- ⚙️ Fully configurable — 4 personalities, 3 frequency modes, a whole settings panel
Features
🎬 5 Animated Moods
Each mood has a unique CSS sprite animation, color scheme, sound effect, and message pool:
| Mood |
Trigger |
What happens |
| 👋 Wave |
Welcome / manual |
Head bob + waving arm + chime |
| 😤 Angry |
Error detected |
Full body shake, red eyes, buzzer sound |
| 😴 Sleep |
Idle too long |
Float animation, closed eyes, lullaby |
| 🥱 Tired |
Long coding session |
Drooping head, limp arms, yawn tones |
| 🕺 Dance |
Random interruption |
Full body groove, 8-bit jingle |
🏆 12 Achievements
Unlock achievements by committing various coding crimes:
| Achievement |
How to unlock |
| 🩸 First Blood |
Get your first error |
| 🧲 Bug Magnet |
10 errors in one session |
| 💀 Walking Disaster |
50 errors total |
| 💯 Century Club |
100 errors. Wow. |
| 👻 Ghost Coder |
Go idle 5 times in one session |
| 🦉 Insomniac |
Code for 3+ hours straight |
| 🏃 Marathon Coder |
5+ hours total coding time |
| 🔥 On Fire |
5 errors in a row without fixing |
| ✨ Clean Run |
30-min session with zero errors |
| 🦅 The Comeback |
Fix 5 errors in under 2 minutes |
| 🎖️ Veteran |
10 coding sessions |
| 😵 Certified Addict |
30 coding sessions |
🎭 4 Personalities
- 😤 Roasting — "404: Your skills not found 💀"
- 🤗 Friendly — "Errors are how we learn! You got this! 🌟"
- 🔥 Motivating — "DEBUG THAT THING! YOU ARE THE CODE MASTER! 💪"
- 🤪 Chaotic — "HAHAHA BROKEN AGAIN! BEAUTIFUL CHAOS! 🎪"
⚙️ Settings Panel
Open with Ctrl+Shift+P → CodeBuddy: Open Settings or click the status bar item.
- Visual personality picker with sample quotes
- Frequency selector (Chill / Normal / Chaotic)
- Enable/disable toggle
- Live preview buttons for every mood
- Stats reset in the Danger Zone
📊 Stats Dashboard
Open with Ctrl+Shift+P → CodeBuddy: Show Stats & Achievements.
Tracks: session errors, session time, idle count, total errors, total sessions, total coding time, longest session, current error streak, quick fix combos.
Commands
| Command |
Description |
CodeBuddy: Show Avatar |
Manually summon the avatar |
CodeBuddy: Hide Avatar |
Make it go away (temporarily) |
CodeBuddy: Open Settings |
Open the settings UI panel |
CodeBuddy: Show Stats & Achievements |
Open the stats dashboard |
CodeBuddy: Reset All Stats |
Wipe all stats and achievements |
Extension Settings
| Setting |
Type |
Default |
Description |
codebuddy.personality |
string |
roasting |
Avatar personality: friendly, roasting, motivating, chaotic |
codebuddy.frequency |
string |
normal |
Interrupt rate: chill, normal, chaotic |
codebuddy.enabled |
boolean |
true |
Toggle all interruptions |
Known Issues
- Sound effects require user interaction first (browser Web Audio API policy — clicking the VS Code window before it appears fixes this)
- The avatar opens in a side panel; if no space is available it may appear as a tab
Release Notes
See CHANGELOG.md for full history.
1.0.0
Initial release 🎉
Contributing
Issues and PRs welcome at https://github.com/Aditya07024/CodeBuddy.
Made with 😈 to make your coding life slightly more chaotic.
