Obsidian Stats logoObsidian Stats

Mnemoloop

by Marco Pozzecco
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Local-first spaced repetition with FSRS scheduling that never touches your notes. Better retention without note pollution.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Mnemoloop

The active knowledge layer for Obsidian.
FSRS-powered spaced repetition that keeps your notes pristine.

Mnemoloop is a high-performance, 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 this with the state-of-the-art FSRS scheduling algorithm, automatic stale-card detection, and a modern dashboard that makes tracking your learning progress genuinely motivating.

Your notes stay pristine. Your retention improves. Your workflow never leaves Obsidian.

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 is the only Obsidian plugin with native FSRS scheduling—the same scientifically validated algorithm powering modern Anki. Better retention. Fewer reviews. Less frustration. No context switching.

Stale Card Detection

When you edit a source note, Mnemoloop automatically flags linked flashcards as STALE, so you never accidentally review outdated information.

Built for Mobile from Day One

Swipe to rate. Tap to flip. Responsive layouts. Mnemoloop works as beautifully on your phone as on your desktop—no separate app required, because it runs natively inside Obsidian Mobile.

Industrial-Grade 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 State-of-the-art spaced repetition algorithm for optimal retention
📄 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

Coming soon

Feature Description
🤖 AI-Powered Flashcard Generation AI generates flashcards from source notes, keeping your knowledge base up-to-date (paid feature)
📱 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
📈 Learning Analytics Track your learning progress with real-time analytics and progress tracking

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

For manual installation, download main.js, manifest.json, and styles.css from the latest release and place them in your vault's .obsidian/plugins/knowledge-accelerator/ directory.

Create Your First Flashcard

Open the Command Palette (Ctrl/Cmd + P) and run:

  • "Mnemoloop: Create Empty Flashcard" — start from scratch
  • "Mnemoloop: Generate Flashcard from Selection" — turn selected text into a card
  • "Mnemoloop: Generate Flashcards from File" — bulk-create from a note (right-click file in explorer)

Review

Open the Command Palette and run "Mnemoloop: 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
  • Swipe left / right — Rate on mobile

Decks & Organization

Organize flashcards into decks using YAML frontmatter:

---
decks:
  - 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:

---
id: abc-123-uuid
created: 2026-05-15
decks:
  - Biology::Cell structure
tags:
  - exam-prep
stability: 4.5
difficulty: 3.2
state: 2
last_review: 2026-05-10
next_review: 2026-05-15
---

What is the powerhouse of the cell?

?

The mitochondrion.

The ? delimiter separates question from answer (configurable in settings). All SRS metadata lives in YAML—transparent, editable, and portable.

Available Commands

Command Palette

Command ID Description
Open Dashboard mnemoloop-open-dashboard Open the learning dashboard
Open Settings mnemoloop-open-settings Open plugin settings
Create Empty Flashcard mnemoloop-create-empty-flashcard Create a new flashcard file

Editor Context Menu

  • Generate flashcard from selection — Creates a flashcard from the currently selected text
  • Create empty flashcard in side panel — Opens a blank flashcard in the right sidebar

File Explorer Context Menu

  • Generate flashcards from file — Bulk-generates flashcards from the selected Markdown file

Contributing

cd apps/plugin
npm install
npm run dev       # development with hot reload
npm test          # run the test suite
npm run lint      # lint TypeScript and Svelte files
npm run build     # production build
npm run 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
  • layerchart — Data visualization for the dashboard

License

MIT © 2026 Marco Pozzecco

Sponsors