Insert coin · MCP server · MIT
MIYAGI
WAX ON · WAX OFF
A coding tutor that lives in your editor and refuses to do the work for you. It hands you the next command, explains it at your level, and turns every result into a lesson, narrated aloud by your own machine.
Player
TERMINAL NOVICE
LV 1 · 40 XP
15 XP a command, 25 for a correct quiz answer with a streak multiplier, level is XP over 100. Saved to disk, so a restart costs you nothing.
$ npx -y miyagi-mcpAttract mode
A REAL SESSION
Captured output, not a mock-up. Watch it run a command, hand back a card, mark a quiz, then refuse to delete anything.
Example session. Command: echo drill. Output: # Miyagi · `echo drill` ## Roadmap Absolute Beginners → Command Line Basics Progress: [█░░░░░░░░░░░] step 1/10 ## Execution EXECUTED. Exit code 0 ✅ drill ## Quiz Which shell variable holds the exit code of the command that just finished? A. $? B. $! C. $0 D. $#
8
tools over stdio
9
danger classes screened
2
runtime dependencies
16
tests, on Node 18/20/22
Ranks
CLIMB THE LADDER
Level 01 · Setup
THREE LINES
No keys, no account. It runs on your machine, so your client only needs permission to start it.
{
"mcpServers": {
"miyagi": {
"command": "npx",
"args": ["-y", "miyagi-mcp"]
}
}
}| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | .cursor/mcp.json, or ~/.cursor/mcp.json |
| AntiGravity / Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Claude Code | claude mcp add miyagi -- npx -y miyagi-mcp |
Level 02 · Loot
WHAT A CARD DROPS
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.
Level 03 · Read this first
IT RUNS SHELL COMMANDS
The cabinet is fun. This part is not a joke, so it is written straight: what the protection is, and where it stops.
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.
Level 04 · Moves
EIGHT TOOLS
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.
Level 05 · Ask
QUESTIONS?
Ask Miyagi
Answers from the written recordIt answers from what is actually written about this server and the rest of the site. If something is not in the record it says so rather than inventing it, which is the part worth testing.