Changelog
Track the evolution of Git Quest — your GitHub history is your character.
Git Warriors, follow @gitquest_dev for patch notes and updates →From the Founder
The story behind Git Quest
My name is Fabricio Souza, and I created this project over a weekend. It started as a short project for an application to Y Combinator Startup School 2026, but what began as a small project evolved into what you see now.
This is a game made by a solo developer, for developers. You'll find plenty of easter eggs in the items, skills and monsters. Little inside jokes and references that only we understand. We're in Season 0 right now, learning how things work and gauging your acceptance. The first step is complete, and we're here together.
What we have today is listed below in the Season 0 feature list — 8 character classes, procedural dungeons, auto-battle, loot, leaderboards, and a complete RPG game loop powered by your real GitHub activity. What we're building next starts with audio in v0.1, followed by multiplayer features, guilds, and eventually full monetization with cosmetics (never pay-to-win).
This wouldn't have been possible without https://github.com/fcsouza/agent-skills — I created a complete library of skills that helped me deliver this MVP so quickly. This is my first game, but after today, I believe it won't be my last.
If you want to experiment or test new ideas, I recommend visiting the repository and exploring all the skills — even if just to copy them. If they help you like they helped me, you're already ahead of many people in building what you want.
Follow @gitquest_dev on X for patch notes, upcoming features, and everything happening in the GitVerse.
Coming in v0.1 and Beyond
Planned Features
- Sound effects for combat, loot drops, and level ups
- Dungeon biome ambience
- New character classes (Elixir Alchemist, PHP Necromancer, C# Summoner, Swift Druid)
- New Leaderboards (weekly, monthly, friends, endless floor records)
- New Items and Abilities
- Achievements
- Quests and events
- Daily login rewards
- The Git Wars
- Main Branch World Area
- Pull Request Plaza social hub
- And Many More...
Stop wasting your ultimate on trash mobs — set the order your abilities fire in combat.
New: Ability Priority
- Tap "Set Priority" in the Abilities panel to enter reorder mode
- Drag abilities up or down with ↑ / ↓ arrows — numbered badges show the new firing order
- Save the order and your auto-battle engine will follow it exactly — primary first, ultimate saved for bosses, whatever you prefer
- Passive abilities always apply at battle start and cannot be reordered
- Future-proofed for boss and PvP strategies — the API already accepts named strategies (default, boss, pvp…)
Farm your favourite floor — retry or replay dungeons without going back to the menu, and see which difficulties you've already conquered at a glance.
New: Retry & Play Again
- Defeat screen now has a "↺ Retry" button — instantly restart at the same floor without navigating away
- Victory screen (max floor cleared) now has a "↺ Play Again from Floor 1" button — farm the full difficulty from the top
- Conquered badge is permanent — replaying from floor 1 does not remove it
New: Conquered Badges
- Difficulty selector cards show a ✓ badge when you've cleared all floors of that difficulty
- Badges are per-biome — conquering Feature Forest Local does not mark Bug Swamp Local as done
Smarter inventory — see your gear's stats at a glance and compare bag items against what you have equipped.
UX: Equipment Stat Display
- Equipment slot cards now show the stat bonuses of the equipped item (ATK, DEF, HP, MP, SPD) directly below the rarity badge
UX: Bag Item Comparison
- Bag items show a stat delta against the currently equipped item in the same slot — green (+N) for gains, red (-N) for losses
- Stats present on the equipped item but absent on the bag item are shown as 0 so you know what you'd lose by swapping
- Consumables and empty slots show no delta — comparison only appears when a direct swap is possible
GitHub is no longer required — play with Discord and link GitHub later to unlock full progression.
New: Discord Login
- Sign in with Discord on the login page — no GitHub account required
- Discord users get a manual class picker: choose any of the 8 classes yourself
- Limited progression without GitHub — battle XP still works, but GitHub syncs and stat bonuses (streaks, PRs, stars) require a linked GitHub account
New: Link GitHub Later
- "Unlock Full Progression" banner appears on your dashboard if you signed in with Discord
- Click "Connect GitHub" to link your account and unlock stat bonuses from streaks, PRs, and stars — plus GitHub XP from commits and code reviews
Play any class you want — plus multi-hero economy gets real with hero creation costs and independent XP.
New: Free Class Choice
- "My language doesn't define me" — toggle on the Reveal screen to pick any of the 8 classes, not just your top GitHub languages
New: Hero Creation Cost
- Creating a new hero now costs 1,000 Lines from your active hero — choose wisely
Balance: Hero XP
- New heroes start at 0 XP and earn their own progression through syncs and battles
- Can't swap or create heroes while in a dungeon — finish the fight first
You asked, we listened — feature requests are now a real thing.
New: Feature Requests
- Head to the new Feedback page (link in the dashboard) to suggest features and vote on what gets built next
- Submit a request with a title and optional description
- Vote on any open, planned, or in-progress request to show your support — the most-voted ideas get built first
- Track the status of every request: Open → Planned → In Progress → Done
- Your own pending submissions appear separately so you know they're in the queue
First post-launch patch — difficulty now actually matters, and you can finally rage-quit a dungeon.
New: Abandon Run
- You can now leave an active dungeon at any time — hit "Abandon" in the dungeon header
- Two-step confirmation prevents accidental rage-quits
- Abandoned runs show in your zone history so you can track the shame
Balance: Combat Mana & Healing
- Mana no longer regenerates during combat — abilities fire automatically until mana runs out. The deeper you go in a floor, the more you fight on raw stats alone. Rest rooms now restore 10% mana.
- Rest rooms restore 15% HP (down from 20%) — still worth stopping for, but not a full reset
Balance: Difficulty Scaling
- Development, Production, and Endless difficulties now make enemies genuinely harder — not just more floors
- Enemies in higher difficulties hit harder and have more HP. Local is still a warmup. Production will hurt.
- Endless mode scales up with every floor — floor 20 enemies are nearly twice as strong as floor 1
- High-defense builds no longer completely ignore damage on hard difficulties — enemies always land something
MVP launch — the GitVerse awakens. 33 of 34 planned features shipped, 798 tests passing, all core systems operational. Bugs included. Adventure guaranteed.
Authentication & Core Systems
- GitHub OAuth integration — your commits are your power
- Anti-abuse engine with quality scoring and daily caps
- 8 character classes based on programming language (Python Sage, JS Rogue, TS Paladin, Rust Guardian, Go Scout, Ruby Bard, Java Architect, C++ Berserker)
- Stats engine mapping GitHub activity to RPG stats (commits → mana, stars → prestige, PRs → skill power)
Game Systems
- Procedural dungeon generation (3 biomes: Feature Forest, Bug Swamp, Deprecated Archive)
- Auto-battle engine — server-side combat running every 30 seconds
- Loot system — 36 items across 5 rarities with weighted drops
- Ability system — 32 unique abilities (4 per class)
- Inventory management — 5 equipment slots (weapon, armor, accessory, offhand, helmet)
Social Features
- Global leaderboard — top 100 developers
- Class leaderboards — compete within your language
- Player presence counter — see how many developers are coding right now
- World map — 3 explorable locations (Feature Forest, Bug Swamp, Deprecated Archive)
Frontend UI
- Landing page with live leaderboard preview
- "The Reveal" — animated character class reveal sequence
- Character dashboard ("The Main Branch") — stats, gear, abilities
- Dungeon viewer — real-time battle progress
- Inventory screen — equipment management
- Leaderboard display — global and class rankings
- World map interface — location selection and lore
Infrastructure
- PostgreSQL + Drizzle ORM — structured game data
- ElysiaJS — high-performance game server and API
- Better Auth — secure authentication with GitHub OAuth
- Redis — leaderboards and player presence
- CI/CD pipeline — GitHub Actions for automated testing and deployment
- 798 tests — 472 backend unit, 143 backend integration, 133 frontend unit, 50 E2E