llm-tutor

Pick up a paused tutoring session. Finds the user's active in-progress topic, briefly reorients them (where they are, what's acquired, what's coming), and hands the dialogue back to the active persona. If multiple topics are in progress, asks which one. Invoke when you're returning after a break. Triggers: '/tutor-resume', 'continue', 'pick up where I left off', 'back to the tutor', 'resume tutoring'.

Show the llm-tutor dashboard — XP total, cycles balance with time-until-next-refill, active topics with progress, completed topics with XP earned, and lifetime stats. Invoke with no arguments. Triggers: '/tutor-status', 'show me my tutor status', 'how am I doing', 'check my XP', 'where am I at with the tutor'.

Start a Socratic tutoring journey on any user-supplied topic. Generates a learning path of 5-8 prerequisite concepts, calibrates the user's knowledge via 3 graduated prompts, charges 1 cycle, and hands off to the active Echo/Cipher/Vex persona for the dialogue. Invoke with the subject as an argument (e.g. /tutor-start 'python decorators'), or with no argument to be asked. DOES auto-trigger on: 'tutor me on X', 'tutor me through X', 'start a tutoring session on X', '/tutor-start'. DOES NOT auto-trigger on colloquial 'teach me X' or 'explain X' — those usually mean the user wants a quick answer, not a 30-90 minute Socratic dialogue.

Check whether llm-tutor has a newer release on GitHub and, if so, surface what's new along with the two commands needed to upgrade. Triggers: '/tutor-update', 'check for llm-tutor updates', 'is there a new tutor version', 'update the tutor', 'pull latest tutor'.

Switch llm-tutor statusline icon mode between emoji (default), nerd (Nerd Font glyphs), unicode (geometric text-presentation symbols), and ascii (pure 7-bit fallback). Mirrors claude-statusline's /statusline-icons. Pass an explicit mode name or no argument to cycle. Triggers: '/tutor-statusline-icons', '/tutor-statusline-icons nerd', 'switch tutor statusline to nerd font', 'change tutor statusline icons to ascii'.

Install the llm-tutor statusline integration. Wraps your existing Claude Code statusline (any statusline — claude-statusline, custom, none) so llm-tutor's segment renders as an extra row alongside it. Saves your original statusline command so /tutor-statusline-uninstall can restore it. Triggers: '/tutor-statusline-install', 'install the tutor statusline', 'show my tutor progress in the statusline', 'enable tutor in statusline'.

Toggle the llm-tutor statusline segment on or off without uninstalling the wrapper. When off, the wrapper still runs but only emits the user's original statusline — zero visible change vs. no integration. Triggers: '/tutor-statusline-toggle', '/tutor-statusline-toggle on', '/tutor-statusline-toggle off', 'turn the tutor statusline off', 'hide the tutor statusline', 'show the tutor statusline'.

Uninstall the llm-tutor statusline integration. Restores the user's original Claude Code statusline command from before /tutor-statusline-install. Leaves tutoring state (XP, cycles, topics) intact. Triggers: '/tutor-statusline-uninstall', 'remove the tutor statusline', 'unwrap the statusline', 'restore my statusline'.

Start a Socratic tutoring journey grounded in an actual codebase. Reads files via Read/Grep/Glob to build the learning path; concepts carry file:symbol anchors so the tutor can reference real code. Invoke with a path: /tutor-codebase ./my-repo (defaults to 'overview' aspect) or /tutor-codebase ./my-repo 'auth flow' (scoped aspect). Triggers: '/tutor-codebase', 'tutor me through this codebase', 'teach me how this repo works', 'help me understand this code'. Distinct from /tutor-start: this one reads real files to ground the curriculum.

Close an active tutoring topic. Calculates XP earned from per-concept first-attempt quality, marks the topic complete in state, runs the hybrid feedback flow (thumbs + targeted rotating question with cycles rewards), and logs feedback for later analysis. Invoke when you're done with a topic. Use with no arg to close the currently-active topic, or pass a slug (/tutor-done python-decorators) to close a specific one. Triggers: '/tutor-done', 'I'm done with this topic', 'close out this tutoring session', 'mark this complete'.

Show the learning path for an active or completed tutoring topic — the ordered list of prerequisite concepts with progress markers and dependency annotations. Internal-by-default; the path is generated by /tutor-start but kept hidden unless the user explicitly asks to see it. Invoke with no arg to show the current in-progress topic, or pass a slug (/tutor-path python-decorators) for a specific one. Triggers: '/tutor-path', 'show me the path', 'what are we covering', 'show me the curriculum', 'how many concepts left'.

Start a tutoring session on the current working directory — convenience wrapper for /tutor-codebase against $PWD. Accepts an optional aspect: /tutor-project (defaults to overview) or /tutor-project 'how requests flow'. Triggers: '/tutor-project', 'tutor me on this project', 'tutor me on what I'm working on', 'teach me this'.