Captured output, replayed. Not a mock-up, which on a page about a teaching tool is the first thing you would check.

• [█░░░]Terminal NoviceLevel 1
• [██░░]Shell ApprenticeLevel 3
• [███░]CLI ArtisanLevel 6
• [████]Terminal WizardLevel 10

15 XP a command, 25 for a correct quiz with a streak multiplier, level is XP over 100. Written to ~/.miyagi/profile.json, so a restart costs nothing.

Add this to your client. No keys, no account.

{
  "mcpServers": {
    "miyagi": {
      "command": "npx",
      "args": ["-y", "miyagi-mcp"]
    }
  }
}

• 01 Roadmap alignment

  Where the command sits on your track, and which step you are on.

• 02 What / How / Trade-offs

  The same command explained three ways, pitched at Junior, Mid or Senior.

• 03 Mental model

  A Mermaid flowchart of what the shell actually does with it.

• 04 Common pitfalls

  The mistakes this command specifically invites, not generic advice.

• 05 Curated docs

  A short set including the man page, rather than a search link.

• 06 Active recall quiz

  One question you answer back, which is where the XP comes from.

It executes shell commands on your machine. Read this before you install it.

• ! Nothing catastrophic executes

  Nine classes are pattern-matched and forced into dry-run: recursive delete, raw device writes, filesystem formats, fork bombs, disk overwrites, host power state, world-writable recursion, piping remote code into a shell, and history-rewriting force pushes.

• ! The screen does not trust its caller

  The tool accepts an is_dangerous flag but re-derives the verdict itself, then ORs the two. The threat model is a model reaching for a vivid example mid-lesson, not a careless human, so a flag the caller supplies cannot be the thing protecting you from the caller.

• ! A denylist is a backstop, not a sandbox

  The real boundary is your client’s own approval prompt, with you reading the command first. Commands run with your privileges in your directory: no container, no restricted user, no syscall filter.

• ! Failures teach instead of crashing

  A non-zero exit returns a diagnostic with a troubleshooting ladder rather than a thrown error. Commands cap at 60 seconds and 4 MB. No network calls, no telemetry, no keys.

• run_teaching_commandExecute or dry-run a command and return the full teaching card.
• verify_quiz_answerGrade the quiz, update your streak and XP, speak the feedback.
• get_next_roadmap_commandThe next copy-pasteable command for where you are.
• set_active_roadmapSet category, roadmap, topic and step counters.
• quick_configSwitch skill level, track or voice in one call. Also resets progress.
• configure_voiceToggle audio and set words per minute.
• get_user_statsXP, level, title, streaks, badges and the title ladder.
• export_roadmap_notesWrite a ROADMAP_PROGRESS.md summary of the session.