idleIQ
Adaptive brain training suite with Math Quiz, Sudoku, and Zip Puzzle — Keep your mind sharp during idle moments with 3 engaging games that adapt to your skill level.
Stay focused during AI processing time with quick mental exercises and logic puzzles, right in your IDE!
✨ Features
🎯 Progressive Difficulty System (V2)
- 9 Difficulty Levels - From 2-digit addition to complex mixed operations
- Intelligent Progression - Advance after 3 consecutive correct answers
- Smart Regression - Gentle drops to keep you in the optimal challenge zone
- Recovery Mode - Easier advancement after struggles to rebuild confidence
🧩 Sudoku Puzzles (V3)
- 4 Difficulty Levels - Beginner, Easy, Medium, Hard
- Unlock at Level 3 - Reach Level 3 in math quiz to unlock Sudoku
- Progressive Unlocking - Complete 3 puzzles to unlock next difficulty
- Real-time Validation - Instant conflict detection and highlighting
- Statistics Tracking - Best times, completion rates, and streaks
- Keyboard Navigation - Full keyboard support (arrows + numbers)
🎯 Zip Puzzle - Sliding Tiles (V4) 🆕
- 4 Difficulty Levels - 5×5, 6×6, 7×7, 8×8 grids
- Unlock via Sudoku - Complete 3 Sudoku Level 1 puzzles to unlock
- Smart Generation - All puzzles guaranteed solvable
- Dual Input - Mouse clicks or arrow keys
- Performance Tracking - Best moves, times, and efficiency ratings
- Interactive Tutorial - First-time guidance for new players
🧮 Comprehensive Math Operations
- Level 1-3: Addition & Subtraction (2-digit to 3-digit)
- Level 4-6: Multiplication (1-digit tables to 2-digit × 2-digit)
- Level 7-8: Division (simple to complex)
- Level 9: Mixed Operations (master level)
📊 Adaptive Learning
- Within-Level Difficulty - Questions adjust based on your performance
- Operation Tracking - Monitors your accuracy by operation type
- Peak Level Achievement - Track your highest level reached
🎨 Enhanced UI
- Level Indicators - See your current level with difficulty stars (⭐⭐⭐)
- Progress Dots - Visual progress toward next level (●●○)
- Recovery Badge - Know when recovery mode is active (🛟)
- Level Change Notifications - Celebrate advancements, encourage after drops
- Encouraging Messages - Random motivational popups on correct answers
- Smooth Animations - Polished transitions for all UI elements
- Triple Views - Switch between Math Quiz, Sudoku, and Zip Puzzle seamlessly
💾 State Persistence
- All progress saved across sessions
- Level history tracking
- Operation performance statistics
- Sudoku puzzle state and statistics
- Zip Puzzle progress and best scores
- Automatic migration from V1/V2/V3
🌙 Developer-Friendly
- Theme Compatible - Works with all VS Code themes
- Sidebar Integration - Accessible from Explorer sidebar
- Lightweight - No performance impact on your IDE
- Keyboard Friendly - Quick access and navigation
📥 Installation
- Open VS Code or Cursor
- Go to Extensions (
Ctrl+Shift+X / Cmd+Shift+X)
- Search for "idleIQ"
- Click Install
🚀 Usage
Math Quiz
- Open the Explorer sidebar (files view)
- Find idleIQ - Math Quiz in the bottom section
- Click to open the quiz panel
- Click Start Quiz and answer questions
- Watch your level progress as you improve!
Sudoku (Unlocks at Level 3)
- Reach Level 3 in the math quiz
- Click the 🧩 Sudoku button in the quiz view
- Select difficulty and start solving puzzles
- Use mouse or keyboard (arrows + numbers) to play
Zip Puzzle (Unlocks after Sudoku L1)
- Complete 3 Sudoku puzzles at Level 1 (Beginner)
- Click the 🎯 Zip Puzzle button in the quiz view
- Select difficulty (5×5 to 8×8 grids)
- Use mouse clicks or arrow keys to slide tiles
- Solve the puzzle in minimum moves!
🎮 How the Difficulty System Works
Math Quiz Progression
- ✅ Advance: Get 3 consecutive correct answers → move up 1 level
- 📉 Soft Drop: Get 1 incorrect answer → drop 1 level
- 🛟 Hard Drop: Get 3 consecutive incorrect at same level → drop 2 levels + activate recovery mode
Sudoku Progression
- ✅ Unlock Next Level: Complete 3 puzzles at current difficulty
- 🎯 Manual Selection: Choose any unlocked difficulty level
- 📊 Independent Progress: Sudoku and math quiz progress separately
Zip Puzzle Progression
- ✅ Unlock Next Level: Complete 3 puzzles at current difficulty
- 🎯 Manual Selection: Choose any unlocked difficulty level
- 📊 Performance Tracking: Best moves, times, and efficiency ratings
Recovery Mode (Math Quiz)
After a hard drop, recovery mode activates for 5 questions:
- Only need 2 consecutive correct to advance (instead of 3)
- No soft drops during recovery
- Helps you regain momentum and confidence
Adaptive Questions
Within each level, questions adjust:
- After incorrect: Easier questions (smaller numbers)
- After multiple correct: Harder questions (larger numbers)
- Keeps you in the optimal challenge zone
📈 Level Overview
Math Quiz Levels
| Level |
Description |
Difficulty |
Example |
| 1 |
2-Digit Add/Sub |
⭐⭐ |
45 + 67 = ? |
| 2 |
2-Digit Mixed |
⭐⭐ |
78 + 85 = ? |
| 3 |
3-Digit Add/Sub |
⭐⭐⭐ |
456 + 789 = ? |
| 4 |
1-Digit Multiply |
⭐⭐⭐ |
7 × 8 = ? |
| 5 |
1-Digit × 2-Digit |
⭐⭐⭐⭐ |
7 × 23 = ? |
| 6 |
2-Digit Multiply |
⭐⭐⭐⭐⭐ |
23 × 45 = ? |
| 7 |
Simple Division |
⭐⭐⭐⭐ |
84 ÷ 7 = ? |
| 8 |
Complex Division |
⭐⭐⭐⭐⭐ |
756 ÷ 18 = ? |
| 9 |
Mixed Operations |
⭐⭐⭐⭐⭐⭐ |
All types |
Sudoku Levels
| Level |
Description |
Clues |
Techniques |
Time |
| 1 |
Beginner |
45-50 |
Naked singles |
5-8 min |
| 2 |
Easy |
38-44 |
Hidden singles |
8-12 min |
| 3 |
Medium |
32-37 |
Naked pairs |
12-18 min |
| 4 |
Hard |
26-31 |
Advanced |
18-30 min |
Zip Puzzle Levels
| Level |
Grid Size |
Tiles |
Optimal Moves |
Difficulty |
| 1 |
5×5 |
24 |
80-120 |
⭐⭐ |
| 2 |
6×6 |
35 |
120-180 |
⭐⭐⭐ |
| 3 |
7×7 |
48 |
180-250 |
⭐⭐⭐⭐ |
| 4 |
8×8 |
63 |
250-350 |
⭐⭐⭐⭐⭐ |
🎯 Why idleIQ?
During AI execution, compilation, or waiting for builds, developers often lose focus by switching to distracting apps. idleIQ keeps you engaged with quick mental exercises that:
- ✅ Maintain your flow state
- 🧠 Keep your mind sharp
- 📊 Adapt to your skill level
- 🎯 Provide clear progression goals
- 🏆 Celebrate your achievements
- 🧩 Offer variety with 3 different game modes
🔄 What's New
V4.0 (Latest) - Zip Puzzle Feature 🆕
- 🎯 Zip Puzzle (sliding tiles) with 4 difficulty levels
- 🔓 Unlock system (requires 3 Sudoku L1 completions)
- ⌨️ Dual input support (mouse + keyboard)
- 📊 Performance tracking (moves, time, efficiency)
- 🎓 Interactive first-time tutorial
- 🎨 Adaptive grid rendering (5×5 to 8×8)
- 💾 V3 → V4 migration with auto-unlock for existing users
V3.0 - Sudoku Feature
- 🧩 Sudoku puzzle game with 4 difficulty levels
- 🔓 Unlock system (requires Math Level 3)
- ⌨️ Full keyboard navigation support
- 📊 Sudoku statistics and best times
- 🎨 Compact UI that fits in sidebar
- 🔄 Seamless switching between Math Quiz and Sudoku
- 💾 V2 → V3 migration with auto-unlock for existing users
V2.0 - Progressive Difficulty
- 🎯 9-level progressive difficulty system
- 🧠 Adaptive question selection
- 📊 Operation performance tracking
- 🎨 Complete UI redesign with visual feedback
- 🛟 Recovery mode for confidence building
- 💾 Enhanced state persistence
- 🏆 Achievement tracking
🤝 Feedback & Support
Have suggestions or found a bug? Visit our GitHub repository to report issues or contribute.
📄 License
MIT
Made with ❤️ for developers who want to stay sharp during idle moments
