Shell Quest v0.1.0

Shell Quest v0.1.0

A pirate-themed terminal learning game for kids ages 3-10.

What's included

• Bubble Tea split-pane TUI — story/map on the left, fake terminal on the right
• Sandboxed virtual filesystem — no real files touched, ever
• 3 difficulty tiers with tier-appropriate command sets:
  • Beginner (ages 3-6): ls, cd, pwd, cat, echo, clear, help
  • Explorer (ages 6-8): + mkdir, touch, cp, mv, rm, find
  • Master (ages 8-10): + grep, chmod, man, history, pipes (|), globs (*), redirect (>)
• Skull Island — 2-mission treasure hunt with clues, hidden files, and narrative
• Mission objective tracking with hints after 3 failed attempts
• Player profiles saved to ~/.shellquest/progress.db (SQLite, no server)
• Adventure log (Ctrl+L) — tracks mission progress
• Parent mode (Ctrl+P) — math gate for changing settings
• Welcome screen with ASCII pirate art

Running

go run ./cmd/shellquest

Or build:

go build -o shellquest ./cmd/shellquest
./shellquest

Requires Go 1.23+. No external dependencies beyond Go modules.