$ cat projects/codementor-ai.md
CodeMentor AI — Agentic Coding Tutor
Chat with a tutor, run its code right there. 17 visual steppers + spaced repetition.
// why: Chat, runner, and visualizer lived in 3 tabs — nothing showed what actually executes.
TL;DR
- Chat + run in one place: every tutor answer has a runnable Monaco editor attached
- 17 synced sims: BST to system design, line-highlighted with the tracer
- Never dead: 4-tier model cascade ends in offline mode, ~600 tests green
// what does it do?
An agentic coding tutor on a Groq-first cascade (Groq → Gemini → OpenRouter → offline). Every answer ships with a runnable Monaco editor — Pyodide in a Web Worker locally or Wandbox server-side. 17 steppers stay synced to the tracer, tied together by a 59-topic curriculum DAG.
// why this project?
Learning to code usually means three tabs: a chat window, somewhere to run code, and an algorithm visualizer. Nothing connects the teaching conversation to what actually executes on screen.
// what broke / learned
Hardest part was keeping 17 sims in sync with the tracer without jank; moved docs out of a 2.88 MB bundle after it hurt load.
// results
- Simulations from BST up to system design stay in sync with the code tracer's line highlighting. SM-2 spaced repetition schedules reviews from how you actually performed, not just what you clicked. The complexity profiler curve-fits measured runtimes against the target O-class instead of trusting the model's claim. Docs moved out of a 2.88 MB client bundle into server-rendered JSON entries, backed by six RLS-enabled Supabase migrations. About 600 tests in 81 suites are green.
Tech stack