| name | md-reviewer-review |
| description | Use when you generate a review-worthy Markdown document (a spec, plan, design doc, PRD, or any doc the user asked you to draft for their feedback) and the user should review it before you continue. Opens the doc in md-reviewer and blocks until the user submits inline comments. |
Send Markdown to md-reviewer for review
When you produce a Markdown document the user should review before you act on it
— a spec, plan, design doc, PRD, or anything they asked you to draft for feedback
— hand it to md-reviewer instead of asking them to review it in the terminal.
How
-
Run the CLI as a background Bash task (run_in_background: true). It blocks
until the user submits their review:
md-review <path-to-file.md>
Do not run it in the foreground — a review can take many minutes and would
time out.
-
Tell the user the document is open in md-reviewer and you are waiting for their
review. Then stop. Do not poll, do not re-read the file, do not proceed.
-
When the background task exits, its stdout is the user's review — a list of
quoted passages with comments, or No comments — looks good as-is. (their
approval). Act on it directly.
Notes
- The user reviews by highlighting passages and leaving comments, then clicking
Send to agent. That button is what makes the CLI return.
- If stdout is
No review submitted (timed out)., the user did not submit within
the timeout — ask whether they still want to review.
- Requires the
md-review CLI on PATH and the md-reviewer app installed. If the
command is not found, fall back to asking the user to review the file manually.
