devquest 0.9.0

Gamify your developer journey.

DevQuest is not a Git wrapper.
It is a terminal RPG where programming is the gameplay.

---

The world

  Git is a sword.
  Deploy is a battle.
  Bug is an enemy.
  Merge Conflict is a boss.

Every real developer action becomes a quest. XP and Gold only drop when the work actually lands.

---

Install

pip install devquest

Then awaken your hero:

hero init

---

Gameplay loop

┌─────────────────────────────────────────────────────────────┐
│  hero commit                                                │
│                                                             │
│  ╭─────────────────────╮                                    │
│  │ Prepare for battle! │                                    │
│  ╰─────────────────────╯                                    │
│                                                             │
│  Merge Conflict                                             │
│  HP [████████████░░░░░░░░] 48/80                            │
│                                                             │
│  Attack 1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%     │
│  CRITICAL HIT! 42 damage!                                   │
│                                                             │
│  ╭──────────────────────────────╮                           │
│  │ Victory!                     │                           │
│  │ Enemy Defeated: Merge Conflict│                          │
│  │ +40 XP   +20 Gold            │                           │
│  ╰──────────────────────────────╯                           │
│                                                             │
│  ╭──────────────────────────────╮                           │
│  │ LEVEL UP!                    │                           │
│  │ Level 5 · Bug Hunter         │                           │
│  ╰──────────────────────────────╯                           │
└─────────────────────────────────────────────────────────────┘

hero push   →  siege the fortress (origin/<branch>)
hero status →  XP bar, title, equipped gear, quests
hero quests →  daily missions that reset with the sun

---

Commands

Command	What happens
hero init	Create your hero profile
hero status	Sheet: level, XP bar, gold, gear
hero commit	Battle an enemy, then commit
hero push	Assault the remote fortress
hero achievements	Trophy hall
hero quests	Daily quest board
hero inventory	Cosmetic loot (--equip <key>)
hero shop	Spend gold (--buy <key>)
hero dashboard	Full Textual menu (arrows + q)
hero config	Settings (--theme, --sounds on/off)
hero theme	List or switch color themes

---

Themes & Sounds

Config lives at ~/.devquest/config.toml:

theme = "cyberpunk"
animations = true
sounds = false

Themes: cyberpunk, matrix, retro, nord, dracula, catppuccin, windows95

hero theme matrix
hero config --sounds on

Sounds are optional and off by default (level up, crit, achievement, quest, victory).

---

Progression

Titles
  Code Apprentice  →  Bug Hunter  →  Senior Warrior  →  Legendary Engineer

Combat
  Hit · Miss · Critical · Boss encounters

Economy
  Gold from real commits/pushes → cosmetic shop only
  (no pay-to-win, ever)

---

Quick start

pip install devquest
cd your-repo
hero init
hero status
hero commit
hero push
hero dashboard

Local development:

pip install -e .

---

Philosophy

The terminal should feel like a game world.
Programming should feel like an adventure.

Read more in vision.md.

---

Docs

File	Purpose
vision.md	Product vision
ROADMAP.md	Release plan
CONTRIBUTING.md	How to contribute
PUBLISH.md	PyPI release guide

---

_{⚔ May your builds be green and your merges conflict-free.}