Mnemoloop

by Marco Pozzecco
5
4
3
2
1
Score: 56/100

Description

A FSRS powered spaced repetition plugin for Obsidian

Reviews

No reviews yet.

Stats

4
stars
1,734
downloads
0
forks
142
days
6
days
6
days
23
total PRs
0
open PRs
0
closed PRs
23
merged PRs
14
total issues
1
open issues
13
closed issues
915
commits

Latest Version

7 days ago

Changelog

2.2.0 (2026-11-13)

Features

  • cloze: render previews with deletion placeholders (b24dec6)
  • flashcard: report write outcome and resolve files through the index (302d309)
  • manage: rebuild the view as a read-only index with a sheet editor (58c4e01)
  • sidebar: add delete to the flashcard edit form (26f77ea)
  • sidebar: add the note-bound flashcard capture panel (#38) (228efd7)
  • ui: add a visually-hidden utility (c29352c)
  • ui: add Badge and Sheet elements (a527325)
  • ui: grow text fields with content and expose live input (027ad7f)

Bug Fixes

  • manage: fold overflowing deck chips and name the hidden decks (c973f0d)
  • manage: hand the index to scan cards at the tablet breakpoint (3a90939)
  • release: restore valid release metadata (a840334)
  • resolve merge conflict markers in release metadata (22cad6d)

README file from

Github

Mnemoloop

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
🔔 Stale Detection Source note edits automatically flag linked flashcards as STALE

Coming soon

Feature Description
🤖 AI-Powered Flashcard Generation AI generates flashcards from source notes, keeping your knowledge base up-to-date (paid feature)

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

  1. Open Settings → Community Plugins in Obsidian
  2. Search for "Mnemoloop" and install
  3. Enable the plugin

Create Your First Flashcard

Creating a card happens in the flashcard sidebar:

  • Open the Command Palette (Ctrl/Cmd + P) and run Open flashcard sidebar, then click New card on the note you are reading;
  • Or right-click a note in the File Explorer and select Create flashcard from file: the sidebar opens with the source pre-filled with a link to that note;
  • Pick a Basic, Sequence, Quiz, or Cloze type, enter your content, optionally assign one or more decks, and confirm.

The card is saved as its own Markdown file in your flashcards directory.

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 Open flashcard sidebar Reveal the flashcard panel bound to the active note
File menu Create flashcard from file Open the flashcard sidebar's create 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-fsrs for 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