tlc/markdown-review
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Antigravity-style inline comment-on-markdown for Claude (MCP-Apps plugin).
3 commits 1 branch 0 tags 1.6 MiB
Find a file
Ravix DeWolf 5e1d66754a v1.0.0 — fix inline-bundle build ($-replace dup + </script> escape), widget self-fetch, frontmatter strip, content-height; marketplace -> git.tlcailab.com
2026-06-23 01:09:56 -05:00
.claude-plugin v1.0.0 — fix inline-bundle build ($-replace dup + </script> escape), widget self-fetch, frontmatter strip, content-height; marketplace -> git.tlcailab.com 2026-06-23 01:09:56 -05:00
commands markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
server v1.0.0 — fix inline-bundle build ($-replace dup + </script> escape), widget self-fetch, frontmatter strip, content-height; marketplace -> git.tlcailab.com 2026-06-23 01:09:56 -05:00
skills/review-markdown markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
.gitattributes Add .gitattributes (normalize EOL to LF) 2026-06-09 00:58:55 -05:00
.gitignore markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
.mcp.json markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
DESIGN.md markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
LICENSE markdown-review v0.0.1 spike: comment-on-markdown -> agent (MCP Apps) 2026-06-09 00:58:36 -05:00
README.md v1.0.0 — fix inline-bundle build ($-replace dup + </script> escape), widget self-fetch, frontmatter strip, content-height; marketplace -> git.tlcailab.com 2026-06-23 01:09:56 -05:00

README.md

markdown-review

Antigravity-style comment-on-markdown → send-to-agent for Claude, as a clean, installable plugin. Open a .md file in a live viewer, highlight a span, leave a comment, and send it to Claude — without leaving the conversation.

Built on MCP Apps (the same interactive-webview mechanism Anthropic's pdf-viewer plugin uses). The comment panel renders inside Claude Desktop.

Three ways to comment

Action What it does
Answer Now Sends one comment to Claude immediately — a quick fix or question, without breaking your reading flow. Ephemeral.
Add to batch Hold a comment while you keep reading. Nothing is sent yet.
Submit All Flush the whole batch to Claude as one message, and save it to a sidecar so the review survives a reload.

A per-session Edit / Review toggle controls what a batch does: in Edit mode Claude applies the comments as edits to the file; in Review mode they become a punch-list it works through with your approval.

Comments are stored in a sidecar (.claude/md-comments/<hash>.json) so your markdown stays clean. (Memory-only and inline-marker backends are on the roadmap — see DESIGN.md.)

Install

/plugin marketplace add https://git.tlcailab.com/tlc/markdown-review
/plugin install markdown-review@tlc-plugins

(or /plugin marketplace add <local-path> to install from a clone.)

The plugin ships a prebuilt, self-contained server (server/dist/), so there is no npm install step on a fresh machine — it runs on node alone.

Use

/review path/to/notes.md            # opens in edit mode
/review path/to/spec.md review      # opens in review (punch-list) mode

…or just ask: "open README.md so I can comment on it."

Develop

Source lives in server/src/ (TypeScript). Rebuild the shipped artifacts:

cd server
npm install
npm run build       # -> dist/index.js (server) + dist/mcp-app.html (webview)
npm run typecheck
node test/smoke.mjs  # end-to-end server contract test
  • src/server.ts — MCP tools (open_markdown, app-only submit_batch) + UI resource
  • src/main.ts — stdio / HTTP transports
  • src/storage.ts — sidecar persistence
  • src/app/ — the webview (index.html + mcp-app.ts, markdown-it renderer + comment UI)
  • build.mjs — esbuild bundling to self-contained dist/

License

MIT © TLC AI Lab