Home - bjsi/incremental-everything GitHub Wiki

Welcome to the official User's Manual for the Incremental Everything plugin for RemNote!

This Wiki is your comprehensive guide to mastering a powerful learning technique inspired by SuperMemo's Incremental Reading. Whether you want to read books and articles in parallel, watch videos incrementally, or manage your writing projects more effectively, this plugin allows you to seamlessly interleave all of your learning material directly into your daily flashcard queue.

Use the pages in this manual to guide you from your first steps to advanced workflows. Let's get started!

🎥 Videos about the basics

See the latest changes and improvements in our Changelog.

🚀 Incremental Everything: Your Complete Learning System is Here

TL;DR: The plugin now delivers a complete learning workflow from first encounter with material to lifetime retention, with robust prioritization to handle information overload. Works seamlessly on mobile too!

Hey RemNote community! 👋

I'm excited to share that Incremental Everything (Plus) has reached a major milestone. Since implementing flashcard priorities in v0.2.0, I've been focused on completing the missing pieces of the learning puzzle. The result? A comprehensive system that handles the entire learning lifecycle while giving you the tools to manage the inevitable information overflow.

🎯 What Makes This Complete Now?

The Full Learning Flow

1. First Contact → Acquisition (Incremental Reading)

  • Import PDFs, articles, and reading material into your queue
  • Read actively using page-by-page control with rem-specific progress tracking
  • Extract insights and create flashcards as you read
  • Priority system ensures you process your most important material first

2. Active Processing → Understanding (Mixed Review)

  • Alternate between passive reading (IncRems) and active recall (flashcards) in a single session
  • Priority Review Documents let you create custom study sessions mixing both types
  • Study your top 50-100 priority items when facing thousands of due cards
  • Everything sorted by priority, not just chronologically

3. Long-term → Mastery (Spaced Repetition)

  • Flashcards inherit priorities from their parent notes
  • High-priority cards get preferential review scheduling (through the Priority Review Document)
  • Priority Shields track whether you're keeping up with critical material
  • Manual priority override for any card or note

The Prioritization Solution

Here's the reality of serious learning: you will always have more to learn than time available. Traditional SRS systems ignore this, treating all due cards equally. Incremental Everything embraces it:

  • Dual Priority Systems: Separate priorities for reading material (IncRems) and flashcards
  • Inheritance by Default: Child cards inherit priorities from parent notes automatically
  • Priority Shields: Visual feedback showing your capacity to keep up with high-priority reviews (both absolute priority and relative percentile)
  • Comprehensive Scope: Priorities work across documents, portals, backlinks, and folder queues
  • Priority Review Documents: Generate focused review sessions of your top N items when overwhelmed

Managing the Overflow

The breakthrough feature is Priority Review Documents. When you have 5,000 due cards:

  1. Press Opt+Shift+R (Mac) / Alt+Shift+R (Windows/Linux)
  2. Select your scope (document/folder or full KB)
  3. Choose item count (e.g., 100) and flashcard/IncRem ratio (e.g., 6:1)
  4. Review a manageable session of your highest-priority items
  5. Rest assured that your critical knowledge is protected

The priority shield graphs show you exactly how well you're keeping up with important material over time. If you're consistently processing only the top 4% of priority material, you'll see that reflected—and can adjust your workflow accordingly.

📱 Now Mobile-Ready!

v0.2.9 adds automatic Light Mode switching for iOS/Android:

  • Prevents mobile crashes from resource-intensive features
  • Auto-detects your device and adjusts performance mode
  • Desktop still gets full feature set
  • Seamless experience across all devices

🎨 Performance Modes

Light Mode (default, recommended for web/mobile):

  • Manual priority tools for flashcards
  • Fast, stable performance
  • Essential features only

Full Mode (Desktop App recommended):

  • Automatic priority inheritance and caching
  • Relative priority percentiles
  • Priority shield tracking with universe size
  • Background pre-tagging of flashcards
  • Complete feature set

💡 Why This Matters for SRS Enthusiasts

If you're familiar with Anki or any SRS system (except SuperMemo), you know the pain:

  • Queue explosion when life gets busy
  • All-or-nothing review sessions
  • No way to triage when overwhelmed
  • Guilt over skipped reviews

Incremental Everything solves this by:

  • ✅ Guaranteeing high-priority items get reviewed
  • ✅ Mixing acquisition and retention in one flow
  • ✅ Tracking your capacity with priority shields
  • ✅ Providing escape hatches (Priority Review Documents) when overwhelmed

The minimum cost comes from intelligent prioritization—you spend your limited study time on what matters most, not on whatever happens to be due today.

🔧 Technical Highlights

  • Comprehensive scope calculation (descendants, portals, backlinks, sources, table views inside the document)
  • Session-based caching for instant queue performance
  • Smart priority inheritance algorithms
  • Historical priority shield tracking with universe size
  • Batch priority assignment tools
  • Dark mode support throughout

🎓 Who Is This For?

  • Students managing multiple courses/subjects
  • Researchers tracking literature
  • Professionals building knowledge bases
  • Anyone serious about long-term learning
  • People who've felt overwhelmed by their SRS queue

🚀 Getting Started

  1. Install Incremental Everything (Plus) from RemNote plugin library
  2. Tag any rem with #Incremental (using Alt+X or Alt+Shift+X) to add it to your reading queue
  3. Set priorities (Alt+P) on important material
  4. Enter queue and start reviewing
  5. Use Priority Review Documents when overwhelmed

The workflow is designed to grow with you—start simple, add complexity as needed.

🙏 Feedback Welcome

This represents months of iteration to build a complete learning system. I'd love to hear from the community:

  • What workflows are you using?
  • What features would enhance your process?
  • How are you handling information overload?

The goal is to make RemNote the ultimate tool for serious, long-term learners. Let me know what you think!

Happy learning! 📚✨

Planned User's Manual Structure

We will make these contents available incrementally!

  • 1. Getting Started

    • Purpose: The first stop for any new user.
    • Content:
      • How to install the plugin.
      • A simple, step-by-step guide to creating your very first Incremental Rem (e.g., from a regular Rem and from a PDF highlight).

  • 2. The Philosophy: What is Incrementalism?

    • Purpose: To explain the "why" behind the plugin. "Flow of incremental reading" explained.
    • Content:
      • A brief introduction to the concepts of Incremental Reading, Writing, and Video.
      • Explain the benefits: avoiding burnout, fostering creativity, and tackling large volumes of material in parallel.

  • 3. The Core Loop: Reviewing Items in the Queue

    • Purpose: This is the main "how-to" guide for daily use. Button functions explained.
    • Content: A guide to the Answer Buttons bar.
      • Next: How it works and what the interval text means.
      • Reschedule: How to manually set a new interval.
      • Done: How to finish an item and remove it from the queue.
      • Change Priority: Its basic function of opening the priority menu.
      • Review & Open: The workflow for moving from the queue to the editor.
      • Scroll to Highlight: Its function for PDF extracts.
      • Strategic Guide to the Answer Buttons: In-depth explanation of when to use each action.

  • 4. Mastering the Queue: Prioritization & Sorting

    • Purpose: Explain the priority and sorting menus in a comprehensive guide for advanced queue management.
    • Content:
      • The Priority System Explained: Why priority is important.
      • Priority Inheritance System: when you create a new incremental rem, it automatically inherits the priority of its closest parent or ancestor that is also an incremental rem.
      • The "Set Priority" Popup: A detailed breakdown of the redesigned popup, explaining the absolute vs. relative sliders and the color gradient.
      • The Sorting Criteria Menu: An explanation of the Flashcard Ratio and Randomness sliders and how they affect what you see in the queue.
      • The Priority Shield: diagnostic tool to help you understand and manage your learning process, giving you a clear, numerical value for your "Priority Protection" — your capacity to process high-priority material on any given day and over time.
      • Priorities for Flashcards: understand how can you benefit from this plugin to manage overload of due flashcards. It will allow you to intelligently focus on what is most important with only a few manual prioritization inputs, giving you confidence even when your backlog remains large.
      • The Priority Review Document: this is the only reason for having a flashcard priority system. This priority review document is an intermediate step necessary to give you the ability to select flashcards by priority.
      • How the Plugin Prioritizes Due Items

  • 5. Advanced Workflows & Use Cases

    • Purpose: Practical, step-by-step guides for specific tasks.
    • Content:
      • A detailed guide on Incremental Reading with PDFs and web pages.
      • A walkthrough of Incremental Video.
      • Tips for Incremental Writing.
      • How to use document/folder-specific queues for Subset Review.

  • 6. Keyboard Shortcuts

    • Purpose: A quick reference "cheatsheet" for power users.
    • Content: A simple table listing all the plugin-related shortcuts (e.g., creating incremental Rem, opening the priority menu).

  • 7. FAQ & Troubleshooting

  • 8. Changelog

    • Purpose: Detail the history of updates.