Skip to content
Styling
Free · open source · MIT

Learn the terminal
without breaking things

Miyagi sits inside your editor and teaches by handing you one command at a time. You type it. It explains what happened, warns you about the traps, then asks you a question to make it stick.

Get started freeSee the code

No account. No API key. Nothing to configure but three lines.

You can see yourself improving

Every command and every right answer moves a number. It is saved to your machine, so closing your editor does not wipe the week you just put in.

40

XP toward level 2

1

Quiz streak

1

Level

  • Terminal Novice

    Level 1

  • Shell Apprentice

    Level 3

  • CLI Artisan

    Level 6

  • Terminal Wizard

    Level 10

Watch a real lesson

This is genuine captured output, replayed. It runs a command, marks a quiz, then refuses to delete anything.

miyagi · live session

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. $#

Set up in one minute

  1. 1

    Open your editor's MCP config

    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 Codeclaude mcp add miyagi -- npx -y miyagi-mcp
  2. 2

    Paste this in

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

    Restart, then ask for a lesson

    Try “set my roadmap to Command Line Basics and teach me the first step”. It takes it from there.

What you get every single time

Roadmap alignment

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

What / How / Trade-offs

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

Mental model

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

Common pitfalls

The mistakes this command specifically invites, not generic advice.

Curated docs

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

Active recall quiz

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

Is it safe? Here is the honest answer

It runs real commands on your computer, so you deserve the full picture rather than reassurance.

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.

Everything it can do

run_teaching_command

Execute or dry-run a command and return the full teaching card.

verify_quiz_answer

Grade the quiz, update your streak and XP, speak the feedback.

get_next_roadmap_command

The next copy-pasteable command for where you are.

set_active_roadmap

Set category, roadmap, topic and step counters.

quick_config

Switch skill level, track or voice in one call. Also resets progress.

configure_voice

Toggle audio and set words per minute.

get_user_stats

XP, level, title, streaks, badges and the title ladder.

export_roadmap_notes

Write a ROADMAP_PROGRESS.md summary of the session.

Still deciding? Ask it anything

Ask Miyagi

Answers from the written record

It 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.