Use when the user says "remember this as a flashcard", "make this a flashcard", or otherwise asks to save something into the local flashcard system. Calls the `flashcard` CLI to persist the card.
The user has a local spaced-repetition flashcard system accessed via the flashcard CLI. When they ask to remember something, persist it by invoking flashcard add.
Pick an existing theme first. Run flashcard themes to see the list. Only create a new theme if none of the existing ones fit. Themes group related cards to avoid context switching during review.
Keep Q and A short. The question is rendered in the Claude Code status line (a few lines max). If the concept is long, break it into several smaller cards.
Pick the right card type:
bool — true/false questions. Answer is y or n.mcq — multiple choice with 2–4 options. Invent plausible distractors from the surrounding context. Answer is a letter a/b/c/d.recall — open-ended; user thinks of the answer then grades themselves. Best for definitions, procedures, explanations.Confirm after adding. Tell the user the theme and card type.
Check existing themes:
flashcard themes
Add a boolean card:
flashcard add --theme python --type bool \
--q "Is Python's GIL released during file I/O?" --answer y
Add a multiple-choice card (pipe-separated choices):
flashcard add --theme python --type mcq \
--q "What does list.pop() return?" \
--choices "the removed item|None|the list|an index" --answer a
Add a self-graded recall card:
flashcard add --theme french --type recall \
--q "Conjugate 'aller' in passe compose, 1sg" \
--answer "je suis alle(e)"
If flashcard add returns "duplicate card", the user already has this one — tell them and skip. If it fails with any other error, report the error verbatim; do not invent a workaround.