oathready

Practice for the Canadian citizenship test in your terminal.

npx oathready

That's it. A 20-question mock test from a verified bank of 393 questions based on the official Discover Canada study guide, with instant explanations for every answer and a pass mark of 15/20, same as the real thing. Flashcards, a shared daily question, and the full browsable bank are one subcommand away.

Why

I built OathReady while studying for my own Canadian citizenship test. This is the terminal version: same question bank, zero setup, works offline. If you are one of the many engineers who moved here through Express Entry and your test is coming up, this is for you.

Usage

npx oathready               20-question mock test (the default)
npx oathready daily         today's question, the same one for everyone
npx oathready flashcards    flip cards and grade yourself; misses come back
npx oathready one           a single random question
npx oathready list          the whole bank with answers (pipe to less or grep)

Every command takes --topic <slug>, and the quiz and flashcard modes take --count <n>:

npx oathready --topic law --count 5
npx oathready flashcards --topic history
npx oathready list | grep -A5 "Vimy"

Topics: history, government, geography, rights, symbols, economy, law. Add --no-color for plain output (NO_COLOR is respected too).

Use the arrow keys (or j/k) and Enter, or just press a/b/c/d. In flashcards, any key flips the card, then y means you knew it and n sends it back into the deck. q quits anywhere.

Privacy

No network, no analytics, no accounts. The questions ship inside the package, so it works on a plane. The only thing it writes is ~/.oathready.json, a local file with your played dates and best score so your streak survives between runs. Delete it any time.

The bigger picture

• Full practice with progress tracking, weak-topic drills, streaks, duels, and every province's questions: oathready.ca
• Using Claude, ChatGPT, or another MCP client? Add the OathReady MCP server and your assistant becomes a quizmaster: oathready.ca/developers

License

MIT. Question explanations are original writing based on the public Discover Canada study guide.