Open Source · MIT Licensed

Review AI Agent's Work

Markdown viewer and review app for Windows and Mac: Make inline comments for AI agents to fix.

↓ Download View on GitHub

How It Works

1.

Your AI agent writes a proposal

2.

You review the proposal with /mdownreview:open

Browse the file tree, read rendered markdown, and leave inline review comments.

Files
📄 PLAN.md 1
📄 README.md
PLAN.md
1## Rollout Plan
2
3Ship to all users on Monday.
You issue
Too risky — start with a 10% canary, not full rollout
4Monitor metrics for 48 hours.
3.

You ask agent to read comments with /mdownreview:read

Your agent scans all .review.yaml sidecars and lists every unresolved comment.

4.

You ask agent to address the comments with /mdownreview:review

Your agent reads comments, makes fixes, and marks them resolved.

5.

You clean up with /mdownreview:cleanup

Removes .review.yaml sidecar files once all comments are resolved.

Download & Install

1.

Download the app

Detecting platform…
Loading…
Not your platform? View all releases on GitHub →

After downloading the DMG (macOS)

  1. Open the .dmg file.
  2. Drag mdownreview.app to your Applications folder.
  3. Open Terminal and clear the Gatekeeper quarantine: 
    xattr -d com.apple.quarantine /Applications/mdownreview.app
  4. Double-click mdownreview in Applications. The app will launch.
Why does Windows show "Unrecognized app"?

Windows SmartScreen flags new executables that haven't built a reputation yet. mdownreview is a free, open-source app and we don't pay for an EV code-signing certificate (~$300+/year). On first launch, click "More info" in the SmartScreen dialog, then "Run anyway". The warning disappears after a few launches as the app builds local trust.

The auto-updater verifies updates with our own minisign signing key (independent of Microsoft's reputation system) so updates are cryptographically authenticated.

Why isn't this app signed?

mdownreview is a free, open-source desktop app and we don't pay for an Apple Developer ID ($99/yr). The app and its CLI are ad-hoc signed, which means macOS won't trust them on first launch when downloaded via a browser (it shows "app is damaged" or "from an unidentified developer"). The script installer above sidesteps this entirely — no quarantine is applied when downloading via curl. If you prefer the DMG path, follow the three-step walkthrough above to clear the quarantine flag once.

The app's auto-updater uses our own minisign signing key (separate from Apple codesign) so updates are still cryptographically verified. See docs/features/installation.md for details.

2.

Install agent skills

Install plugins for Claude, GitHub Copilot CLI and other coding agents

/plugin marketplace add dryotta/mdownreview-skills
/plugin install mdownreview@mdownreview-skills