# AdventureOS — Product Overview

AdventureOS is a self-hosted personal companion for building long-term consistency through a nostalgic personal-OS adventure experience.

See the full product specification in your Cursor plan file. Key modules:

- **Command Centre** — Character overview, Today's Adventure, Daily Reflection
- **Library Wing** — Books, page logging, soft streaks, completion celebrations
- **Cartographer's Desk** — Weekly Explorations (optional curiosity quests)
- **Statistics Hall** — Historical views and trends
- **Weekly Review** — Mentor's letter and week summary
- **The Guide** — Local LLM quest giver (Ollama)
- **The Teacher** — Flashcards, quizzes, research assignments
- **Achievement Gallery** — 20+ milestones
- **Control Panel** — Settings, templates, export, themes

## Anti-Burnout Rules

- No XP loss, no streak destruction, no failure screens
- Grace days and rest days
- Welcome back flow after absence
- Partial credit on all adventure items