Mnemoloop
Marco Pozzecco286 downloadsLocal-first spaced repetition with FSRS scheduling that never touches your notes. Better retention without note pollution.
- Overview
- Scorecard
- Updates11
The active knowledge layer for Obsidian.
FSRS-powered spaced repetition that keeps your notes pristine.
Mnemoloop is a local-first spaced repetition system built directly into Obsidian. Unlike plugins that embed flashcard syntax into your source notes, Mnemoloop stores every flashcard as its own Markdown file: portable, git-friendly, and completely isolated from your thinking space. It pairs FSRS scheduling with a dashboard for heatmaps, deck trees, and retention analytics, so you review more in less time without leaving Obsidian.
Your notes stay pristine. Your retention improves. Your workflow never leaves Obsidian. Start remembering more, reviewing less.
Why Mnemoloop?
Your Notes Stay Pristine
Every flashcard is a standalone Markdown file in a dedicated directory, linked back to its source note via YAML frontmatter. Your thinking space remains exactly as you designed it—no !! or ?? markers polluting your carefully organized literature reviews, course notes or research documents.
FSRS, Inside Obsidian
Mnemoloop brings native FSRS scheduling into Obsidian, the same scientifically validated algorithm powering modern Anki. Better retention, fewer reviews, no context switching.
Built for Mobile from Day One
Swipe to rate. Tap to flip. Responsive layouts. Mnemoloop works as well on your phone as on your desktop, natively inside Obsidian Mobile.
Reliability
Dual-source truth: a fast JSON index for queries, plus human-readable YAML frontmatter on every card for transparency and recovery. Even if the index is corrupted, all your SRS data lives in Markdown and can rebuild everything. Error boundaries ensure the plugin never brings down Obsidian.
Features
| Feature | Description |
|---|---|
| 🧠 FSRS Scheduling | Scientifically validated spaced repetition algorithm for better retention with fewer reviews |
| 📄 1 File = 1 Flashcard | Each card is a standalone Markdown file—portable, version-controllable, never touches source notes |
| 📊 Learning Dashboard | Heatmaps, deck tree, daily goals, and retention rates |
| 🔒 Local-First & Private | Core features work fully offline. No telemetry. No data mining. Your knowledge belongs to you. |
| 🏗️ Self-Healing Data | JSON index + YAML dual-source truth with corruption recovery |
| ⚡ High Performance | Lazy card loading, debounced vault watching, and 50,000-card performance targets |
| 📈 Learning Analytics | Track retention, forecast, and cumulative progress over time |
| 📱 Mobile Touch UI | Swipe left/right to rate, tap to flip: native feel inside Obsidian Mobile |
Coming soon
| Feature | Description |
|---|---|
| 🤖 AI-Powered Flashcard Generation | AI generates flashcards from source notes, keeping your knowledge base up-to-date (paid feature) |
| 🔔 Stale Detection | Source note edits automatically flag linked flashcards as STALE |
Who Is This For?
- Researchers & Academics — Literature reviews, experimental protocols, paper notes. Stale detection catches when your understanding evolves.
- Technical Lifelong Learners — Course notes, code snippets, architecture decisions. Markdown flashcards render code blocks, LaTeX, and tables natively.
- Medical & Law Students — Dense memorization with rich formatting, diagrams, and embeds—exactly as your Obsidian notes already support.
- Obsidian Power Users — You treat your vault as a long-term knowledge asset. Mnemoloop respects that with transparent, portable, future-proof data.
Getting Started
Installation
- Open Settings → Community Plugins in Obsidian
- Search for "Mnemoloop" and install
- Enable the plugin
Create Your First Flashcard
Creating a card is modal-driven:
- Open the Command Palette (
Ctrl/Cmd + P) and run Create flashcard to open the flashcard form; - Right-click a note in the File Explorer and select Create flashcard from file to open the form with the source pre-filled with a link to that note;
- Pick a Basic, Sequence, Quiz, or Cloze tab, enter your content, optionally assign one or more decks, and confirm.
The card is saved as its own Markdown file in your flashcards directory and opened in the editor.
Review
Open the Command Palette and run "Open dashboard" to see your learning stats and start a review session.
During review:
- Space — Flip the card
- 1 / 2 / 3 / 4 — Rate Again / Hard / Good / Easy
- U — Undo last rating
Decks & Organization
Organize flashcards into decks using YAML frontmatter:
---
decks:
- Maths::Linear algebra
- CS::Algorithms
---
A card can belong to multiple decks — in the flashcard form, enter them as a comma-separated list (e.g. Maths::Linear algebra, CS::Algorithms). Use :: for nested decks. Cards without a deck appear under Uncategorized in the deck tree.
Flashcard Format
Each flashcard is a Markdown file with YAML frontmatter:
---
uuid: 550e8400-e29b-41d4-a716-446655440000
source: '[[Biology/Cell biology.md]]'
status: ACTIVE
decks:
- Biology::Cell structure
card_type: basic
stability: 4.5
difficulty: 3.2
elapsed_days: 3
scheduled_days: 5
learning_steps: 1
reps: 4
lapses: 0
state: Review
last_review: 2026-05-10T09:00:00Z
due: 2026-05-15T09:00:00Z
---
What is the powerhouse of the cell?
?
The mitochondrion.
The card_type field selects the card format (defaults to basic), and the ? delimiter separates question from answer (configurable in settings). All SRS metadata lives in YAML—transparent, editable, and portable.
Card Types
Mnemoloop supports four card types. Pick one in the flashcard form, or set card_type in YAML when authoring cards by hand.
Basic
A question and an answer, separated by the marker (? by default). During review, flip the card to reveal the answer and rate it manually.
---
card_type: basic
---
What is the powerhouse of the cell?
?
The mitochondrion.
Sequence
A question plus an ordered list of steps (at least two). During review the steps are shuffled — drag them back into the correct order (drag works with touch on mobile). The card is scored automatically based on the final order.
---
card_type: sequence
---
Arrange these steps in order.
?
- Receive the signal
- Transcribe the DNA
- Translate the mRNA
Quiz
A question with multiple-choice options, where the correct option is marked with [x]. During review the options are shuffled and the card is scored automatically based on your selection.
---
card_type: quiz
---
What is the powerhouse of the cell?
?
- [ ] Nucleus
- [x] Mitochondrion
- [ ] Ribosome
Cloze
Text with one or more deletions written as {{c1::answer}} (optionally {{c1::answer::hint}}). During review each deletion is revealed one at a time; rate the card manually.
---
card_type: cloze
---
The powerhouse of the cell is the {{c1::mitochondrion}}.
Available Commands
| Context | Command | Description |
|---|---|---|
| Palette | Open dashboard | Open the learning dashboard |
| Palette | Create flashcard | Open the flashcard form to create a new card |
| File menu | Create flashcard from file | Open the flashcard form pre-linked to the selected Markdown file |
Contributing
yarn install
yarn dev # development with hot reload
yarn test # run the test suite
yarn lint # lint TypeScript and Svelte files
yarn build # production build
yarn format # format code with Prettier
For detailed architecture guidance, code patterns, and conventions, see AGENTS.md.
Tech Stack
- TypeScript — Strict mode, path aliases (
@/*) - Svelte 5 — Runes-based reactive UI (
$props,$state,$effect) - Vite — Build toolchain with auto-copy to Obsidian plugin directory
- FSRS —
ts-fsrsfor state-of-the-art spaced repetition scheduling - Vitest — Unit testing with mocked Obsidian API
- Zod — Runtime schema validation
- bits-ui — Headless Svelte UI primitives
- @dnd-kit/svelte — Drag-and-drop for reordering sequence cards
- layerchart — Data visualization for the dashboard
License
MIT © 2026 Marco Pozzecco