Just for Fun

dsh-devquest

lucky8197/dsh-devquest · ★ 8

lucky8197Curated

Turns coding into an RPG: finished turns, tool calls and completed todos earn XP, with 27+ achievement badges, levels, titles and seasons. Event-driven scoring with a pure-function engine — the work itself is the game.

License
BSD-3-Clause
Added
2026-08-16
Maintenance
active
Install kind
github
npm
dsh-devquest
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-08-19
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:lucky8197/dsh-devquest

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. 🎮 How It Works
  2. ✨ Key Features
  3. 🎴 Adventure (v1.4.0)
  4. 🎮 Progression
  5. 📅 Daily & Weekly
  6. 🗓️ Season & Shop
  7. 🎨 Personality & Looks
  8. 📊 Data & Experience
  9. 🖥️ Screenshot
  10. ⚙️ Install
  11. 📄 License

中文 | English

DevQuest is a DSH plugin: every turn, tool call, todo and token output in your agent is converted into XP by fixed rules. XP raises your level, levels unlock titles, and achievements track how far you've come. Install it and do nothing else — normal work scores automatically.


🎮 How It Works

Nothing to configure — just work, and XP accrues:

You do You get
✅ Complete a turn +10 XP, combo +1
🧰 Call a tool +1 XP (crafting tools like edit/cmd/SSH +2, capped +10 per turn)
📋 Clear todos +15 XP each
📝 Output tokens +1 XP per 10k
💥 Fail a turn +2 XP (consolation)
💪 Rise after a failure "Rise Again" achievement +100 XP
🎴 Every 20 completed turns Roll the "Fate Dice": a random event card (buff / curse / choice)

✨ Key Features

🎴 Adventure (v1.4.0)

  • 🎴 Random event cards: every 20 turns — ☕ Caffeine Rush (tool XP ×2), 🧘 Deep Focus (token XP ×1.5), 👻 Ghost Bug (next failure won't break combo), 🧱 Tech Debt Collector (next XP wiped), 🥚 Mystery Egg choice, 🌙 Midnight Choice, 🎲 Fate Gamble
  • 🔥 Combo stances: unlock Flow / Surge / Phoenix / Ascend at 10/25/50/100 combo (extra tool XP + token multiplier), shown as a hero badge
  • 🪙 Developer relics: 24 rarity-tiered collectibles dropped from todo sweeps / boss kills (egg buff doubles the chance), with a collection showcase
  • 📜 Epic quest chains: 3 multi-day storylines (Tame the Tech Debt / Legend of the Night Owl / Bug Slayer) — advance daily, reset on a missed day, finales up to +800 XP
  • 👻 Ghost race: your past 7 days of real data become "Past You" — dual progress bars (XP/turns), beat it for +300 XP
  • 💬 Meme-flavored copy: daily quests get meme variants (~60%), weekly bosses draw from a meme-name pool (Refactor Behemoth / Tech Debt Wyrm…)

🎮 Progression

  • ⚔️ Turns/tools/todos/tokens → XP → level → title: a new title every 5 levels (30+ tiers), bigger combo = bigger multipliers
  • 🏆 58 achievements across six categories (Journey/Crafting/Quest/Time/Legend/Egg), rarity-colored, with hidden easter eggs and category collection bonuses

📅 Daily & Weekly

  • 📅 Daily quests: 3 random quests per day (24-quest pool), clear all for a chest
  • 🎯 Daily XP goal: set today's target, claim a reward on reaching it
  • 🗓️ Weekly challenges: 3 goals per week, clear all for a bonus
  • 🐉 Weekly boss: the 3 weekly quests fuse into a boss — slay it for season currency
  • 🎁 Daily lucky draw: free daily draw for XP / currency / items

🗓️ Season & Shop

  • 🗓️ Quarterly seasons: season XP is the shop currency (resets each season, anti-inflation), with a sprint bar, pass milestones, and an auto season wrap-up
  • 🛒 Season shop: combo shields / quest rerolls / XP boost cards / skip cards / title badges

🎨 Personality & Looks

  • 🎨 Theme skins: 10 palettes, buy once — own forever, switch free
  • 🏷️ Multiple titles: level titles + conditional titles (All-Rounder, etc.), switch freely
  • 🃏 Class system: your tool habits reveal a class (Edit Master / Command Runner / Versatile…)

📊 Data & Experience

  • 📈 Growth report / activity calendar / stats / hall of fame: daily XP bars, 30-day heatmap, top-5 tools, season records
  • 📤 Share card: one-click PNG of your level / title / stats
  • 🔊 Sound + desktop notifications: feedback on achievements / level-ups / boss kills (toggleable)
  • 🎨 Customizable panel: font scaling, compact mode, toast filter, drag positioning

🖥️ Screenshot

⚔️ entry at the sidebar bottom; click to open the draggable panel. Achievement/turn-settlement toasts pop in the corner:

⚙️ Install

Option 1: npm (recommended)

dshpm install dsh-devquest --profile web
# or
dsh plugin --profile web add "dsh-devquest"

Option 2: GitHub source

dsh plugin --profile web add "github:lucky8197/dsh-devquest#main"

Restart dsh web → ⚔️ appears at the sidebar bottom.

Agents can query progress too:

devquest_status        # level / XP / combo / daily quests / class / boss
devquest_achievements  # full achievement list & unlock state (58)
devquest_shop          # season shop: balance/items, buy=<itemId>
devquest_daily         # daily+weekly brief (plain text, pushable to IM)
devquest_reset         # reset save (dangerous, needs confirm=true)

📄 License

BSD-3-Clause