Repository navigation
v1.0.0 - Initial Release
shellquest v1.0.0
A passive RPG that lives in your terminal. Your shell is the dungeon.
Features
- 5 classes (Wizard, Warrior, Rogue, Ranger, Necromancer) x 5 races (Human, Elf, Dwarf, Orc, Goblin)
- 150 levels with scaling XP curve and 15 title tiers
- Prestige system — reset to level 1 with a subclass and permanent stat bonuses (15 subclasses)
- 80+ dev-themed loot items across 5 visually distinct rarity tiers (Common → Legendary)
- 25+ command-specific events — git, docker, vim, grep, kill, tar, man, python, sudo, and more
- MUD-style colorized output with rich inline formatting
- 11 directory-based zones with danger scaling
- Auto-combat, auto-equip, adventure journal
- Shell hooks for bash, zsh, and fish
- Atomic saves with race-condition protection
- <1ms tick latency — never slows your shell
Install
cargo install shellquestOr one-liner with auto-setup:
curl -fsSL https://raw.githubusercontent.com/duysqubix/shellquest/main/install.sh | bashQuick Start
sq init # Create your character
sq status # View your character sheet
sq inventory # Check your gear
sq journal # Adventure log
sq prestige # Ascend at level 150