devquest 0.9.1

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.

Commit and push open with short ASCII sprite intros — enemy summon on commit, fortress breach on push. Toggle with hero config --animations off.

---

Install

Global (recommended):

pip install --user devquest
# or, isolated: pipx install devquest

Then awaken your hero:

hero init

Pause / resume / update anytime:

hero disable   # skip gameplay until you want it back
hero enable
hero update    # pip install -U devquest

hero --help also lists these.

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
hero remotes	Scout fortresses (git remote -v)
hero branches	Map all paths (git branch -a)
hero branch <name>	Forge a new branch (+XP)
hero checkout <name>	Travel to another branch
hero disable	Pause DevQuest (gameplay no-ops)
hero enable	Resume after disable
hero update	Upgrade from PyPI

---

Branch control

hero remotes
hero branches
hero branch feature/loot
hero checkout main

Creating a branch awards XP/Gold and can complete the daily Pathfinder quest.

---

Themes & Sounds

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

theme = "cyberpunk"
animations = true
sounds = false
enabled = true

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 --user 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.}