DotMD
Guides.Every part of DotMD, step by step.
Connect your AI agent, review what it writes, and read and edit Markdown on your Mac. Each guide has the steps, the exact commands and the answers to the questions people ask.
macOS 14 or later. Reading is free; DotMD Pro has a 3-day free trial.
Quick answer
Start with your agent's guide: Claude Code, Codex or Cursor. Each one connects the agent to DotMD with one line and shows the review loop. The other guides cover comments, checking fixes, the MCP server, reading and editing.
Connect your agent
One address, http://127.0.0.1:8089/mcp, and a setting or two that differ from agent to agent.
Claude Code
One command connects it. Claude Code sends you its plans and specs, waits while you comment and fixes each comment.
Codex
Add DotMD in the Codex app or in config.toml, with a tool timeout long enough to wait for your review.
Cursor
The same address works in Cursor, Visual Studio Code and any other MCP client.
MCP server
Turn the server on, see what an agent can do and every call it makes, and why it stays on your Mac.
Review, read and edit
With an agent or on your own: comments, an agent's fixes, and Markdown on your Mac.
Comments
Select a passage and press ⌥⌘M. Comments stay tied to their lines and never touch the file.
Reviewing changes
See each fix in the file, old text in red and new in green. Accept it, reopen it, or restore any version.
Reading Markdown
Open any .md file or folder and read it rendered, with tables, code, Mermaid diagrams and math. Free.
The editor
Edit with the rendered page beside the text. Every change goes straight to the file, and every version is kept.
Questions before you start
Which agents work with DotMD?
Any MCP client: Claude Code, Codex, Cursor, VS Code and others. One URL, http://127.0.0.1:8089/mcp, in the agent's MCP settings. DotMD's guide has the exact line for each.
Does the agent need DotMD to be open?
Yes — DotMD runs the MCP server while it's open. Settings → MCP → Start with DotMD keeps it ready.
Is reviewing free?
Reading is free. Comments, reviews and agents over MCP are part of DotMD Pro: Yearly with a 3-day free trial, or Lifetime. See Pricing.
Do I need an account?
No. There are no accounts. Your files, comments and history stay on your Mac. The purchase is tied to an anonymous ID that syncs through your iCloud, so it works on all your Macs.