Study Curve

日本語

Study Curve schedules reviews of whole notes along the Ebbinghaus forgetting curve. Each note you enroll moves up a fixed ladder of intervals (1, 3, 7, 14, 30, 60 and 90 days by default) when you remember it, and drops back to the start when you forget. If you are studying for an exam, give the deck an exam date: reviews that would fall after the exam are pulled in, and every note in the deck comes back in the final days before it.

Other plugins such as Spaced Repetition (flashcards and entire notes) and Note Review Reminder (spaced reviews and reminders) also schedule note reviews. Study Curve treats one note as one topic you should be able to recall, keeps the review state only in each note's frontmatter, and gives every note a "can you recall it?" section and grading criteria through a built-in template. The user interface is currently in Japanese only; see the Japanese UI reference below. English UI is planned.

Features

• Review whole notes. Grade each review with one of four buttons (☆ ◯ △ ✗) and the next review date is set for you
• A review board with each deck's status, today's reviews, upcoming reviews and notes not enrolled yet
• Optional exam dates: reviews are pulled in before the exam, and the whole deck comes back in the final days
• Code blocks for your daily note (study-today, study-forecast, study-progress), so you can grade without opening the board
• "Create review note" makes a note from the built-in template (or your own) and enrolls it right away
• Enroll the existing notes in a deck's folder in bulk, after confirming the count
• The same workflow on Mac, Windows, iPad and phones. The layout follows the available width

How it works

Intervals

Each stage has a fixed interval, and your grade moves the note between stages.

• ◯ Remembered → stage +1 (stays at the last stage)
• △ Unsure → same stage (the same interval again)
• ✗ Forgot → back to stage 0 (comes back tomorrow)
• ☆ New → same stage, but the next review is always 3 days later

☆ is not "forgot" but "I haven't learned this yet". The forgetting curve measures how well you retain something you once learned; grading unlearned material with ◯△✗ would mix "forgot" and "never learned" on the same scale, and the note would never move up. Tomorrow would only test your short-term memory, and a week is too long for something you just met, so it is 3 days.

You can change the intervals in the settings. There is no ease factor (as in SM-2): the stage alone explains why a note is due today.

The clock button (postpone to tomorrow) moves the review one day later (the day after the later of the due date and today) without changing the stage. It is hidden for decks in their final review period.

Exam dates (optional)

If a deck has an exam date, two things happen. Without one, neither does.

1. Pull-in — a review that would fall after the exam date is moved to the exam date
2. Final review — when the exam is less than 7 days away (configurable), every note in the deck shows up in today's reviews regardless of its due date

Getting started

1. Install Study Curve from Community plugins and enable it
2. Open the review board (the brain icon in the ribbon, or the command "復習ボードを開く") and create a deck by following the guidance. If some notes already have study-deck, the board finds those decks and lets you add them to the settings
3. Prepare notes
   • For a new note, use the command "復習ノートを作成" (Create review note) or "＋ ノート" on a deck card
   • For existing notes, enroll them from "未登録のノート" (Notes not enrolled yet) on the board, or open a note and run "このノートを復習対象に登録" (Enroll this note)
4. From the next day, grade your notes in "今日の復習" (Today's reviews) on the board, or in a study-today block in your daily note

Writing review notes

"Create review note" uses this built-in template ({{title}} is the title you enter). The headings are in Japanese; "思い出せるか" means "can you recall it?" and "答え合わせ" means "check your answer".

# {{title}}

## ✅ 思い出せるか（読む前に）

> 例を見て答えを思い浮かべてから、下の答え合わせを読む。

**例1**

**例2**

**例3**

| 判定 | 基準 | 次回 |
|---|---|---|
| **☆ 初見** | この内容を学ぶのが初めて | 3日後 |
| **◯** | 答え合わせの太字を自分の言葉で言えた | ステージ +1 |
| **△** | 太字は言えたが「なぜ」が出てこない | 据え置き |
| **✗** | 一度学んだはずなのに出てこない | 翌日 |

---

## 🎯 答え合わせ — これを覚えていればOK

- **OK**：
- **なぜ**：

• The note is created in the deck's folder (or in Obsidian's default location for new notes). If the name is taken, 1, 2… is appended
• Set "復習ノートのテンプレート" (Review note template) to use your own file instead. {{title}}, {{deck}} and {{date}} are replaced. The template's frontmatter is kept, and the study-* keys are added to it
• The "思い出せるか" heading matches the default heading of the "clear checks after grading" setting

The guide to writing review notes covers writing questions and answers, grading with ☆ ◯ △ ✗, making notes from work notes or with generative AI, and an English version of the template. Finished samples are in docs/examples/en/.

Japanese UI reference

Commands

No hotkeys are assigned by default. Assigning hotkeys to ☆ ◯ △ ✗ lets you grade while reading a note.

Code blocks

Put these in your daily note or weekly review.

```study-today
deck: AWS ANS   # optional: only this deck
limit: 10       # optional: defaults to the daily limit setting
```

```study-forecast
days: 30        # optional: defaults to the forecast days setting
deck: AWS ANS   # optional
```

```study-progress
deck: AWS ANS   # optional
```

• study-today: the same rows as the board, so you can grade inside your daily note
• study-forecast: a bar chart of how many reviews are due in the next N days. Overdue reviews count toward today and are shown in red at the bottom of today's bar
• study-progress: a table of each deck's exam date, enrolled notes, due today, overdue and retention

Settings

• Invalid numbers are not saved; the reason is shown under the field
• A deck's folder is used to list notes not enrolled yet and to pick the deck when enrolling. With nested folders, the deepest match wins
• Renaming a deck also rewrites study-deck in its notes (the count is shown before you save). Deck names written in code blocks (deck:) and in your scripts are not changed
• Deleting a deck asks for confirmation and lets you either keep its notes or unenroll them

Frontmatter reference

The review state lives only in each note's frontmatter. There is no separate database, so a note shows when it is due next, and Dataview can read it.

---
study-deck: AWS DOP      # which deck (exam or subject)
study-next: 2026-09-19   # next review date
study-stage: 2           # review stage
study-history:           # the last 20 grades
  - 2026-09-12 ok
  - 2026-09-16 ok
study-suspended: true    # (optional) pause reviews
---

Unenrolling removes all five keys and leaves the other keys alone.

Mobile

Study Curve works the same on Mac, Windows, iPad and Android (isDesktopOnly: false; no Node or Electron APIs).

The layout follows the width that is actually available, not the device: a phone in portrait, an iPad in split view and the board in a narrow sidebar on a Mac look the same at the same width.

On touch devices, the buttons are large enough to tap easily.

Across devices:

• The review state is in the notes, so it follows your notes through Obsidian Sync, obsidian-git or any other sync
• Don't grade the same note on two devices at the same time. It causes a sync conflict in the note itself
• "Today" is the device's local date. If Obsidian stays open past midnight, the board and blocks redraw with the new date

Privacy and disclosures

• No network requests. Everything runs locally
• Free. No payment, account, ads or telemetry
• It only reads and writes files inside your vault. Open source (MIT)

What it reads:

• The frontmatter of every Markdown note in the vault (from Obsidian's metadata cache), to find enrolled notes. A note can be enrolled in any folder, so every note is checked. Nothing it reads leaves your vault
• The paths of your folders and notes, for the suggestions in the deck folder and "Review note template" fields
• The template file set in "Review note template", when you create a review note
• Only when "Clear checks after grading" is on: the body of the note you grade

What it writes:

• The study-* keys in the frontmatter of enrolled notes (see above)
• Notes created with "Create review note" (in the deck's folder or Obsidian's default location for new notes)
• Only when "Clear checks after grading" is on (off by default): completed checkboxes in the chosen section
• Bulk enrolling, renaming a deck and unenrolling a deleted deck's notes all show the count before writing
• Settings are saved to data.json in the plugin's folder

Scripting

const plugin = app.plugins.plugins['study-curve'];
const queue = plugin.getDueQueue('AWS ANS'); // the deck name is optional

getDueQueue(deckName?) returns today's reviews in the same order as the board (overdue → due today → final review). The due-date and final-review rules stay inside the plugin, so templates (Templater and so on) don't need to copy them.

Development

npm install
npm run build    # type check + production build, no side effects (used by CI and the directory's build check)
npm run dev      # watch build; copies to OBSIDIAN_DEV_PLUGIN_DIR (a test vault) if set
npm test         # unit tests (Vitest)
npm run lint     # ESLint, including manifest.json
npm run deploy   # copies the production build of main to OBSIDIAN_PLUGIN_DIR

Copy .env.example to .env.local and set the paths (.env.local is not committed).

Releases

Pushing a tag (no v, the same as version in manifest.json) makes GitHub Actions create a draft release with main.js, manifest.json and styles.css attached. Check the attachments, then publish it.

npm version patch   # updates manifest.json, package.json and versions.json, commits and tags
git push origin main
git push origin <version>

Always bump the version for a fix; replacing files in an existing release is not picked up.

License

MIT