pi-code-quiz

Active code-reading quiz for pi.

Instead of summarizing code for you, pi-code-quiz shows a real snippet, asks a question, lets you answer in your own words, gives feedback, and lets you discuss that question further.

Screenshot

What it does

• Opens a Glimpse quiz window with a code snippet, question, and answer box
• Builds quizzes from the current workset (inferred active files), session, repo, or a specific file
• Uses pi's active model; thinking level defaults to the current setting, capped at high, but can be overridden
• Keeps questions anchored to visible code snippets
• Gives short feedback plus an ideal answer after you submit
• Lets you open a per-question discussion thread, using broader local source context and recent session context when available
• Supports audience profiles: general, scientist, and developer

Commands

• /quiz — quiz the current workset (inferred active files)
• /quiz workset — explicitly quiz the current workset
• /quiz session — quiz files strongly associated with the current session
• /quiz repo — quiz repo-level structure and central code
• /quiz file <path> — quiz a specific file
• /quiz <path> — shorthand for /quiz file <path> when the path exists
• /quiz ... --thinking off|minimal|low|medium|high — override the model thinking level
• /quiz ... --audience general|scientist|developer — bias the question style for a particular audience
• /quiz ... --mode gen|sci|dev — short alias for --audience
• /quiz-close — close the active quiz window

Audience profiles

• general / gen — balanced, accessible questions mixing concept and code mechanics
• scientist / sci — focuses on quantities, state representations, transformations, assumptions, perturbations, and intuitive meaning
• developer / dev — focuses on interfaces, control flow, contracts, extension points, and debugging/refactoring consequences

scientist mode is meant to push the quiz away from software-trivia or pure contract-checking and toward the meaning of the model and what the code is representing.

Install

From GitHub:

pi install https://github.com/omaclaren/pi-code-quiz

From npm:

pi install npm:pi-code-quiz

Try it without installing:

pi -e https://github.com/omaclaren/pi-code-quiz

After installing, reload or restart pi.

Notes

• pi-code-quiz is for active recall and code understanding, not passive summaries.
• Questions are intended to be answerable from the snippet shown in the quiz window.
• After feedback is shown, you can open a short discussion thread for that card.
• After a set is finished, you can generate more questions from the same scope.
• Quiz packets and quiz runs are stored as hidden session entries.

License

MIT