💡 Why EngramQuest?

Anki solves when to review. EngramQuest solves how to actually remember.

• L2 Contextual Anchor — AI searches your vault, finds what you already knew when you first learned this topic, and rebuilds that moment of understanding. No other flashcard tool does this.
• FSRS algorithm — newer and more accurate than Anki's SM-2. Intervals adapt to your actual recall performance, not fixed multipliers.
• Quest Maps — turn dense long notes into game-like island challenges. You engage with the material instead of re-reading it.

✨ Features

🃏 Review Deck — Remember More, Study Less

A three-stage recall system that builds real memory — not just familiarity:

• FSRS scheduling — intervals adapt to your actual recall, not preset multipliers
• AI cards stay separate — generated cards live in engram-review/, AI never touches your source notes
• Edit writes back — Highlight and Edit tools write changes directly to your source note, keeping it the single source of truth
• Auto-detection — any note tagged #flashcards/topic is picked up automatically
• Source note link — jump from any card to its origin note mid-session, then return right where you left off

🗺️ Quest Map — Turn Notes into Challenges

Transforms any note into a game-like island map, embedded directly in your vault as a .md file.

• 15 challenge types: quiz, true/false, cloze, input, ordering, matching, countdown, snapshot, auction, timeline, chain, memory palace, image quiz, image occlusion, and iframe HTML simulations.
• Persistent progress: completed nodes, progress, and best scores are stored separately from quest YAML, so AI can update a quest without wiping your progress.
• Difficulty tiers: Easy / Medium / Hard — ask your AI for the level you need
• 5 visual themes: Sky Island, Sci-Fi, RPG, Ocean, Minimal
• Boss Battle — a chapter mastery test at the end of each stage

🏆 Achievements

Track your learning milestones with 3D-rendered icons and rarity tiers.

• 10 milestones: from your first card to 2,000 total reviews, 30-day streaks, 50 mastered cards, and more
• Rarity tiers: Uncommon (UC) → Rare (R) → Legendary (LEG) — rarer achievements glow with special borders
• Click any achievement card for your progress data, activity calendar, and daily review records

🧠 Memory Map — See the Big Picture

Visualizes abstract concepts using Obsidian Canvas.

• AI generates a visual knowledge graph — analogies, contrasts, and contextual anchoring make abstract topics stick
• Any file named {note-name}-memory.canvas is auto-detected in Hub → Memory Map
• During review, the Memory Map button finds and opens the matching canvas automatically

🌙 Dark Mode

Seamless automatic theme detection — no manual toggle. Hub, review session, and achievements all switch between light and dark assets automatically.

⚡ Quick Start (AI Path)

1. Install Plugin — Open directly in Obsidian, search EngramQuest in Community Plugins, or download from GitHub Releases.
2. Install Skills — go to Settings → EngramQuest → AI Skills and click Install for your tool (Claude Code, Gemini CLI, Cursor, or Codex).
3. Ask AI — "Turn Note.md into a quest-map medium" or "Build a review deck from notes tagged with math."
4. Open Hub — click the EngramQuest ribbon icon, switch to the relevant tab, and start learning.

✍️ Write Cards Yourself (No AI Required)

Add a #flashcards/topic tag and pick a format. Three formats are freely mixable in one note:

#flashcards/math

Q: What is a derivative?
A: The instantaneous rate of change of a function at a point.
   Formally: lim(h→0) [f(x+h) − f(x)] / h

Q: What does this diagram show?
![[architecture.png]]
A: The architecture of a microservice system.

---
Q: What is Stripe's core model?
A: Stripe is essentially a Saga system.
   It handles payment_intent state machine, retry / failure handling,
   and fund consistency. You only receive the result.
---

%%card%%
Q: How should I explain agentic testing?
A:
Agentic testing checks whether an AI system can complete a task reliably.
---
This separator stays inside the answer.
%%card%%

{{c1::Calculus}} is built on limits, derivatives, and integrals.

Pythagorean theorem :: a² + b² = c²

🔬 Why It Works

EngramQuest is built on four pillars of cognitive science:

❓ FAQ

Q: Do I have to use AI?
No — many users don't. Write cards with ::, Q:/A:, or {{c1::}}, add a #flashcards/topic tag, and the plugin picks them up automatically.

Q: Where is my progress stored?
Scheduling data lives in engram-review/sr/ inside your vault as JSON files. AI-generated cards are in engram-review/ai-cards/. Neither touches your source notes.

Q: Does EngramQuest support Anki?
Partially. The :: and {{c1::}} formats are Anki-compatible — pair them with the Obsidian_to_Anki community plugin. The Q:/A: format is EngramQuest-native (rich multi-line answers) and does not sync to Anki.

Q: How do I make AI always follow a specific pattern when building decks?
Mark key answers in your notes using ==highlight== or **bold**, then add a rule to your AI config file (CLAUDE.md, GEMINI.md, or AGENTS.md):

IMPORTANT: When building a Review Deck, every highlighted ==text== must be turned into a review card.

☕ Support

If EngramQuest is useful to you, consider supporting its development:

Built for lifelong learners. Made with ❤️