Explain mode
Paste any code and choose who will read it — Explain mode generates a WALKTHROUGH.md tuned to that specific audience.
When to use it
- Onboarding a new developer — explain a complex module without a 1:1 session
- Writing context for a code review — explain the design to a reviewer unfamiliar with the area
- Explaining your work to a non-technical stakeholder without dumbing it down yourself
- Creating a WALKTHROUGH.md for an agent to orient itself in an unfamiliar codebase
How to use it
Paste your code
Paste a file, a function, a component, a directory listing, or any block of code. Minimum 30 characters. There's no maximum — paste as much as you need explained.
Choose your audience
Select from the four audience options below. Your choice changes the vocabulary, depth, and structure of the walkthrough significantly.
Generate and copy
The walkthrough is rendered in the output — copy it or download as a .md file. Save it as WALKTHROUGH.md in the relevant directory.
The four audiences
Non-technical reader
Founder, PM, investor, or client. Every term is defined. Plain language throughout. No assumed programming knowledge.
I'm learning this code
Explains the why behind each decision, not just the what. Assumes you can read code but want to understand the design choices.
New team member
Assumes engineering skills. Explains project-specific choices and conventions that aren't obvious from reading the code alone.
AI agent
Terse, machine-parseable walkthrough. Facts and structure over prose. Optimised for an agent working in the codebase.
Via MCP: Use the explain_code tool and pass a file path or directory path — the server reads the actual files from your repo. MCP setup →