██████╗██╗ █████╗ ██╗ ██╗██████╗ ███████╗ ██████╗ ██╗ ██╗███████╗███████╗████████╗
██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝ ██╔═══██╗██║ ██║██╔════╝██╔════╝╚══██╔══╝
██║ ██║ ███████║██║ ██║██║ ██║█████╗ ██║ ██║██║ ██║█████╗ ███████╗ ██║
██║ ██║ ██╔══██║██║ ██║██║ ██║██╔══╝ ██║▄▄ ██║██║ ██║██╔══╝ ╚════██║ ██║
╚██████╗███████╗██║ ██║╚██████╔╝██████╔╝███████╗ ╚██████╔╝╚██████╔╝███████╗███████║ ██║
╚═════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝ ╚══▀▀═╝ ╚═════╝ ╚══════╝╚══════╝ ╚═╝
One command. That's all it takes to begin your quest.
curl -sSL https://raw.githubusercontent.com/SeanZoR/claude-quest/main/install.sh | bashThen restart Claude Code and type:
/quest
Welcome, adventurer. Your journey begins now.
Claude Quest transforms learning Claude Code into an RPG adventure.
Instead of reading documentation and hoping you remember features, you'll:
- 🏆 Unlock 90 achievements as you discover Claude Code's powers
- 📈 Earn XP and level up from Newcomer to Champion
- 🗺️ Follow guided quests that teach you exactly what to do
- 🔍 Track your progress with a beautiful ASCII dashboard
- 🎯 Master every feature without ever feeling lost
Think of it as a game layer that sits on top of Claude Code. Use Claude normally, and achievements unlock automatically. It's like having a quest log for your coding journey.
Run /quest to see your adventure unfold:
╔══════════════════════════════════════════════════════════════════════════════╗
║ ⚔️ CLAUDE QUEST ⚔️ ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ ║
║ Level 7 ⚡ Apprentice XP: 1,250 / 2,000 ║
║ ████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 62% ║
║ ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ 📊 PROGRESS 🏆 RECENT ACHIEVEMENTS ║
║ ───────────────────────────── ────────────────────────────────── ║
║ Achievements: 23/90 (26%) 🔧 Skill Unlocked +100 XP ║
║ Categories: 5/8 started ⚡ Command Crafter +50 XP ║
║ Quests Done: 18 🎣 Hooked +100 XP ║
║ ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ 🗺️ NEXT QUEST ║
║ ───────────────────────────────────────────────────────────────────────── ║
║ #24 "Model Citizen" - Use a custom model configuration ║
║ → Run: /quest learn 24 ║
║ ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ 💡 TIP: You're 2 achievements away from unlocking the Integration tree! ║
╚══════════════════════════════════════════════════════════════════════════════╝
Every achievement tells a story. Here's a taste of what awaits:
| Badge | Achievement | Category | XP | How to Unlock |
|---|---|---|---|---|
| 🌱 | First Memory | Memory | 50 | Add your first note to CLAUDE.md |
| ⚡ | First Command | Commands | 50 | Create your first slash command |
| 🔧 | Skill Unlocked | Skills | 100 | Build and use a custom skill |
| 🎣 | Hooked | Hooks | 100 | Set up your first automation hook |
| 🔌 | First Server | Integration | 100 | Connect an MCP server |
| 🌐 | Web Crawler | Tools | 75 | Use browser automation |
| 🧪 | Test Runner | Workflow | 75 | Run tests through Claude |
| 👑 | Champion | Mastery | 500 | Complete all 90 achievements |
90 achievements await. Can you catch them all?
Eight realms to conquer, each with unique challenges:
| Icon | Category | Achievements | Description |
|---|---|---|---|
| 📝 | Memory Keeper | 12 | Master CLAUDE.md and project memory |
| 🛠️ | Command Crafter | 12 | Create powerful slash commands |
| ✨ | Skill Weaver | 10 | Build reusable skills |
| 🎣 | Hook Master | 10 | Automate with lifecycle hooks |
| 🔌 | Integrator | 12 | Connect MCP servers and tools |
| 🌐 | Tool Wielder | 12 | Master built-in tools |
| 🔄 | Workflow Wizard | 12 | Optimize your development flow |
| 👑 | Champion | 10 | Legendary meta-achievements |
Your journey from newcomer to legend:
THE PATH TO MASTERY
═══════════════════════════════════════════════════════════════════════
🌱 ⚡ 🔥 👑
NEWCOMER APPRENTICE SPECIALIST CHAMPION
L1-4 L5-9 L10-14 L15+
0-500 XP 500-2000 XP 2000-5000 XP 5000+ XP
─────────────────────────────────────────────────────────────────────────
"Every champion "Knowledge "Power grows "You have
was once a becomes with each become
beginner." skill." conquest." legend."
Your quest toolkit:
| Command | Description |
|---|---|
/quest |
View your dashboard and current progress |
/quest scan |
Rescan for newly unlocked achievements |
/quest learn N |
Get a step-by-step tutorial for quest #N |
/quest category X |
Deep dive into a specific category |
/quest all |
View every achievement (spoilers!) |
/quest next |
See your recommended next quest |
/quest stats |
Detailed statistics and analytics |
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ 1. 📦 INSTALL 2. 💻 USE 3. 🏆 UNLOCK │
│ ─────────────── ───────────── ───────────── │
│ Run the install Use Claude Code Achievements pop │
│ script normally up automatically │
│ │
│ 4. 📊 TRACK 5. 📚 LEARN 6. 👑 MASTER │
│ ─────────────── ───────────── ───────────── │
│ Check /quest Follow guided Become a │
│ for progress tutorials Champion │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Zero friction. Claude Quest watches what you do and celebrates your discoveries. No extra commands to remember, no workflows to change. Just use Claude Code, and the game plays itself.
Found a bug? Have an achievement idea? Want to add a new category?
We'd love your help! Check out CONTRIBUTING.md for guidelines.
Some ways to contribute:
- 🐛 Report bugs or issues
- 💡 Suggest new achievements
- 📝 Improve documentation
- 🔧 Submit pull requests
This is an open-source adventure, and everyone's welcome at the tavern.
MIT License - Go forth and quest freely.
╔═══════════════════════════════════════════════════════════════╗
║ ║
║ "The journey of a thousand achievements ║
║ begins with a single /quest." ║
║ ║
║ — Ancient Claude Proverb ║
║ ║
╚═══════════════════════════════════════════════════════════════╝
Ready to begin?
curl -sSL https://raw.githubusercontent.com/SeanZoR/claude-quest/main/install.sh | bash⚔️ Your quest awaits, adventurer. ⚔️
Made with 🎮 by humans who believe learning should be fun.