Codey isn't your typical GitHub stats badge. This is a full-blown RPG system that analyzes your entire coding personality, judges your contributions with zero mercy, and evolves into different creatures based on what you actually code.
No fake motivation. No participation trophies. Just raw, unfiltered feedback on your dev life.
Daily updates via GitHub Actions. Tracks commits, stars, languages, streaks, and more β then brutally scores you on traits like creativity, curiosity, and teamwork. Your pet evolves (or devolves) based on your real GitHub behavior.
β οΈ Current Status: Dev build, needs testers brave enough to face the truth!
Standard GitHub stats: "Wow, you made 500 commits! π"
Codey: "500 commits, 2 stars, 0 followers. Are you coding in a cave?"
This isn't about counting contributions. It's about revealing your true coding personality through a harsh but rewarding RPG system that tracks:
- Social Status β Based on total stars earned (not given)
- Personality Type β Calculated from follower/following ratio (Influencer? Explorer? Balanced?)
- Dominant Language β Your pet evolves based on what you actually code (π Python dragon, π¦ JavaScript fox, π¦ Rust crab, etc.)
- Professional Traits β Creativity, curiosity, teamwork β tracked and displayed
- Achievements β Unlock badges for real milestones:
π₯ Monthly Warrior,π― Commit Master,β Social Star - Prestige System β Hit max level? Reset everything for exclusive rewards and flex harder
- Daily & all-time commit counts
- Stars earned (across ALL your repos)
- Code streak (consecutive days coding)
- Most-used programming language
- Social metrics (followers, following, forks)
- Weekend warrior status (yes, Saturday commits count double)
- Seasonal event participation (Hacktoberfest, Advent of Code)
Important: Codey only counts stars on YOUR repos. Forking popular projects won't save you here.
Codey uses an unforgiving leveling algorithm where:
- Low activity = Your pet gets sad, tired, or dies (temporarily)
- Inconsistent commits = Streak breaks, XP penalties
- No stars on repos = Social status tanks
- Weekend coding = Energy boost, level gains
- Seasonal events = Special bonuses and visual upgrades
Your pet has health, energy, mood, and advanced RPG stats that change based on real behavior:
Mood States:
π happy β β tired β π° stressed β π‘ angry β π dead
βοΈ π€ bored β π΄ sleepy β π΅ overwhelmed
βοΈ β¨ inspired
The exact formulas and brutal penalties are documented in Behind the Scenes β if you dare to look.
Your Codey evolves based on your dominant programming language:
| Language | Pet Form | Why |
|---|---|---|
| Python | π Dragon | Classic, powerful |
| JavaScript | π¦ Fox | Quick, adaptable |
| Rust | π¦ Crab | Memory-safe beast |
| Go | πΉ Gopher | Fast, concurrent |
| TypeScript | π¦ Eagle | Type-safe ruler |
| Ruby | π Gem Guardian | Elegant, refined |
| PHP | π Elephant | Never forgets |
| C/C++ | βοΈ Knight | Low-level warrior |
| Java | β Coffee Spirit | Enterprise soul |
| ...and more | π² Mythical forms | Unlock legendary creatures |
Prestige Mode: After maxing out, reset your stats to unlock mythical forms and special visual badges that prove you're a coding veteran.
- Fork or copy this repo
- Configure tracking mode in
.github/workflows/update_codey.yml - Add the badge to your README
Copy these into your repo:
your-repo/
βββ .github/
β βββ workflows/
β βββ update_codey.yml
βββ update_codey.py
βββ requirements.txt
Edit the workflow's env section:
Option A - Track Single Repo:
env:
GIT_REPOSITORY: 'YourUsername/YourProject'Option B - Track Entire Account (Recommended for profile README):
env:
GIT_REPOSITORY: 'YourUsername'π‘ Pro Tip: For full stats including private repos, use a
GITHUB_TOKENwithrepopermissions.
After the first workflow run, add this to your README.md:
Done! Codey updates daily at midnight UTC and judges you accordingly.
- Commits today
- Current streak
- Energy level
- Mood state
- Total commits
- Total stars earned
- Level & XP
- Achievements unlocked
- Prestige rank (if applicable)
- Creativity β Based on project diversity
- Curiosity β Following/exploring new repos
- Teamwork β Collaboration metrics
Calculated from your social graph:
- Influencer β High followers, low following
- Explorer β Low followers, high following
- Balanced β Even ratio
Unlock special badges for major milestones:
- π₯ Monthly Warrior β 20+ commits this month
- π― Commit Master β 100+ total commits
- β Social Star β 50+ stars earned
- π Night Owl β Commits after midnight
- π Weekend Warrior β Saturday/Sunday coding
Seasonal Boosts:
- π Hacktoberfest (October) β Double XP for PRs
- π Advent of Code (December) β Special daily challenges
- π Repo Birthday β Bonus on your repo's anniversary
- PostgreSQL integration for historical tracking
- Multi-language pet forms (more creatures!)
- Team/organization support
- API endpoint for live stats
- More brutal judging algorithms (yes, really)
- Community leaderboards (compare your pain)
- β
Everyone was a dragonβ Evolution system fixed - β
Codey on drugsβ Energy calculation normalized - β
Some dragonsβ Species diversity restored
Found a bug? Want to add features? PRs welcome!
Ways to contribute:
- Test the No Mercy Edition and report issues
- Add new pet forms for different languages
- Improve the brutal scoring algorithm
- Design new achievements
- Write better insults for low performers (kidding... or am I?)
Apache 2.0 License by Volkan KΓΌcΓΌkbudak
Use it, fork it, judge yourself with it. Just keep the attribution and don't blame me when Codey roasts you.
Built by Volkan Sah β A developer who believes in honest feedback, even when it hurts.
Other projects:
Codey is brutally honest. If you have thin skin about your coding habits, maybe stick to regular GitHub stats.
This pet will:
- Call out your inconsistency
- Judge your commit frequency
- Question your star count
- Mock your broken streaks
But it will also:
- Celebrate real achievements
- Reward consistent effort
- Evolve with your skills
- Make you a better developer (probably)
Remember: Codey is just code. But if it makes you code more, mission accomplished. π―
Check out my Codey in action: volkansah.github.io/Codey
Spoiler: Even I get roasted sometimes. That's the point.
Made with β and brutal honesty
β Star this repo if Codey made you cry (in a good way)