@shaankhosla/repeater 0.0.26 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,28 +1,10 @@
1
- ## [0.0.26] - 2026-01-09
2
-
3
- ### 🚀 Features
4
-
5
- - Autogenerate Clozes with LLMs (#28)
6
- - Utilize ansci defined colors rather than custom colors for TUI theme (#44)
1
+ ## [0.1.1] - 2026-01-19
7
2
 
8
3
  ### 🐛 Bug Fixes
9
4
 
10
- - Update naming from repeat to repeater in LLM module (#46)
11
- - Control characters cause panic in openai headers (#48)
12
-
13
- ### 💼 Other
14
-
15
- - *(deps)* Bump rsa from 0.9.9 to 0.9.10 (#41)
16
- - Rename repeat->repeater
17
- - *(deps)* Bump lru from 0.16.2 to 0.16.3 (#43)
5
+ - Make AI wording clearer (#74)
6
+ - Launch drill with background process (#76)
18
7
 
19
8
  ### 🚜 Refactor
20
9
 
21
- - Change keys used in drill (#42)
22
-
23
- ### 📚 Documentation
24
-
25
- - Make brew install cleaner
26
- - Alias for install
27
- - Add github icon
28
- - Minor rewrite
10
+ - Switch to using auth.json to store keys (#77)
package/README.md CHANGED
@@ -18,46 +18,30 @@
18
18
  `repeater` is a command-line flashcard program that uses [spaced repetition](https://en.wikipedia.org/wiki/Spaced_repetition) to boost your memory retention. It’s like a lightweight, text-based Anki you run in your terminal. Your decks are kept in Markdown, progress is tracked in SQLite, and reviews are scheduled with Free Spaced Repetition Scheduler (FSRS), a state-of-the-art algorithm targeting 90% recall.
19
19
 
20
20
 
21
+ > *"Just tested this out and it's amazing! The ability to simply use the same file to take your notes (e.g., in class) and as your flashcards source file is a serious game-changer. I love how minimalist it is, too."*
22
+ > — Reddit user
23
+
21
24
  <img src="check_example.png" alt="Checking card progress" />
22
25
 
23
26
  > [!NOTE]
24
27
  > You can find the main documentation, including installation guides, at [https://shaankhosla.github.io/repeater/](https://shaankhosla.github.io/repeater/).
25
28
 
26
- ## Features
27
-
28
- - **Markdown-first decks**: write basic Q/A + cloze cards in plain `.md` alongside your notes.
29
- - **Stable card identity**: “meaning-only” hashing; formatting tweaks don’t reset progress.
30
- - **FSRS scheduling**: automatic reviews targeting ~90% recall (simple Pass/Fail).
31
- - **Terminal workflow**: drill TUI, capture editor, and progress dashboard (`drill`, `create`, `check`).
32
- - **Media + migration**: open linked images/audio/video; import Anki `.apkg` to Markdown.
33
- - **Optional LLM helper**: add an OpenAI key once and missing Cloze brackets are auto-suggested before drills.
29
+ ## How is this different than Anki?
34
30
 
31
+ [Anki](https://apps.ankiweb.net) is a powerful and flexible spaced-repetition system with a mature GUI, mobile apps, and a large plugin ecosystem. If you want a highly customizable study system, Anki is an excellent choice.
35
32
 
36
- ## Installation
33
+ `repeater` takes a different approach. Instead of asking you to move your active-recall material into a separate application, your notes themselves are the source of truth. Flashcards live directly inside plain Markdown files, alongside regular notes, and are detected automatically. There is no card editor, no syncing layer, and no separate “collection” to manage.
37
34
 
38
- ### Install script (Linux & macOS) - Recommended
35
+ In practice, this means less flexibility but much less friction. You edit cards the same way you edit notes, using the same tools, and can easily inspect, version, or refactor your material without exports or migrations. The goal is not to replace Anki’s ecosystem, but to offer a simpler, text-first workflow for people who prefer minimalism, the terminal, and plain files over feature depth.
39
36
 
40
- ```
41
- curl --proto '=https' --tlsv1.2 -LsSf https://github.com/shaankhosla/repeater/releases/latest/download/repeater-installer.sh | sh
42
- ```
43
-
44
- ### Homebrew (macOS)
45
-
46
- ```
47
- brew install shaankhosla/tap/repeater
48
- ```
49
-
50
- ### Windows (PowerShell)
51
-
52
- ```
53
- irm https://github.com/shaankhosla/repeater/releases/latest/download/repeater-installer.ps1 | iex
54
- ```
37
+ ## Features
55
38
 
56
- ### npm
39
+ - **Markdown-first decks**: write basic Q/A + cloze cards in plain `.md` alongside your notes.
40
+ - **Media support**: open linked images/audio/video.
41
+ - **Anki import**: import your existing Anki decks `.apkg` to Markdown.
42
+ - **Stable card identity**: “meaning-only” hashing; formatting tweaks don’t reset progress.
43
+ - **Optional LLM helper**: add an OpenAI key once to auto-suggest missing Cloze brackets and optionally rephrase basic questions (see the [docs](https://shaankhosla.github.io/repeater/llm-usage.html)).
57
44
 
58
- ```
59
- npm install @shaankhosla/repeater
60
- ```
61
45
 
62
46
  ## Quick Start
63
47
 
@@ -85,8 +69,36 @@ npm install @shaankhosla/repeater
85
69
  repeater drill cards
86
70
  ```
87
71
 
88
- - `Space`/`Enter`: reveal the answer or cloze.
89
- - `O`: open the first media file (image/audio/video) referenced in the current card before revealing the answer.
90
- - `F`: mark as `Fail`, `Space`/`Enter`: mark as `Pass`.
91
- - `Esc` or `Ctrl+C`: end the session early (progress so far is saved).
92
72
 
73
+ That's it! `repeater` will automatically track progress and schedule reviews.
74
+
75
+
76
+ ## Installation
77
+
78
+ ### Install script (Linux & macOS) - Recommended
79
+
80
+ ```
81
+ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/shaankhosla/repeater/releases/latest/download/repeater-installer.sh | sh
82
+ ```
83
+
84
+ ### Homebrew (macOS)
85
+
86
+ ```
87
+ brew install shaankhosla/tap/repeater
88
+ ```
89
+
90
+ ### Windows (PowerShell)
91
+
92
+ ```
93
+ irm https://github.com/shaankhosla/repeater/releases/latest/download/repeater-installer.ps1 | iex
94
+ ```
95
+
96
+ ### npm
97
+
98
+ ```
99
+ npm install @shaankhosla/repeater
100
+ ```
101
+
102
+ ## Star History
103
+
104
+ [![Star History Chart](https://api.star-history.com/svg?repos=shaankhosla/repeater&type=date&legend=top-left)](https://www.star-history.com/#shaankhosla/repeater&type=date&legend=top-left)
@@ -22,7 +22,7 @@
22
22
  },
23
23
  "hasInstallScript": true,
24
24
  "name": "@shaankhosla/repeater",
25
- "version": "0.0.26"
25
+ "version": "0.1.1"
26
26
  },
27
27
  "node_modules/@isaacs/balanced-match": {
28
28
  "engines": {
@@ -514,5 +514,5 @@
514
514
  }
515
515
  },
516
516
  "requires": true,
517
- "version": "0.0.26"
517
+ "version": "0.1.1"
518
518
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
- "artifactDownloadUrl": "https://github.com/shaankhosla/repeater/releases/download/v0.0.26",
3
- "author": "shaankhosla",
2
+ "artifactDownloadUrl": "https://github.com/shaankhosla/repeater/releases/download/v0.1.1",
3
+ "author": "Shaan Khosla <shaan.khosla@proton.me>",
4
4
  "bin": {
5
5
  "repeater": "run-repeater.js"
6
6
  },
@@ -83,7 +83,7 @@
83
83
  "zipExt": ".tar.xz"
84
84
  }
85
85
  },
86
- "version": "0.0.26",
86
+ "version": "0.1.1",
87
87
  "volta": {
88
88
  "node": "18.14.1",
89
89
  "npm": "9.5.0"