You see the problems. Your agent doesn't.

Annotate your Markdown. Your agent reads it, fixes it, and marks it done.

Download for macOS Download on the Mac App Store
brew install mfreiwald/tap/remark

Free to download · macOS 14+ · Apple Silicon & Intel

Workflow comparison

Your workflow today

  1. 1 Open a PRD in VS Code
  2. 2 Find three problems
  3. 3 Copy the lines out
  4. 4 Write a prompt around them
  5. 5 Send it to Claude Code / Codex
  6. 6 Let the agent change the file
  7. 7 Check the PRD again
  8. 8 Repeat for every issue

8 steps for something that should be one.

With Remark

  1. 1 Select text
  2. 2 Write a comment
  3. 3 Let the agent read and update

That's it.

Remark on macOS showing colour-coded inline comments and their status in the sidebar

Your doc changes. Your comments stay.

Features

Comment what's wrong

Select text. Write what needs fixing. Done.

No copy-paste. No prompt engineering. No lost context.

Your agent reads along

Structured JSON out of the box. Claude, Codex, or your own agent — anyone can read and resolve.

remark cli list --status unresolved

Comments survive edits

Your document changes. Remark finds the text again — or marks it orphaned.

Nothing gets lost.

Folder Review

Open a folder, pick files, review your docs.

Comment History

Full event trail per comment — status and anchor changes.

Native macOS

Built in Swift — fast, lean, and responsive.

From comment to fix

Five steps. No context switching.

1

You comment

"This endpoint needs rate limiting"

2

Agent reads

remark cli list --status unresolved
3

Agent fixes

Updates spec.md

4

Agent resolves

remark cli resolve --id comment-42
5

You see

Status changes to "fixed" ✓

Buy once. Use forever.

Buy it outright, or subscribe in the App Store. No account. No cloud.

$39

Read free. Unlock to comment.

one-time purchase · yours forever

  • Inline comments, CLI, folder review — everything included
  • 14-day free trial — no account, no payment
  • Every update. No extra cost.
Download for macOS
or get it from the Download on the Mac App Store

Not sure you will need it long-term?

$19 per year $3.99 per month

Monthly and yearly run through the Mac App Store version.

Questions

What is Remark?
Remark is a native macOS app that lets you annotate Markdown files with inline comments. Select text, write what needs fixing, and your AI coding agent reads the comments, applies the changes, and marks them done.
Does Remark work with Claude Code, Codex, and other agents?
Yes. Remark ships with a CLI that outputs structured JSON. Any agent that can read tool output — Claude Code, Codex, Cursor, or your own scripts — can consume and resolve Remark comments.
Is it a subscription?
It does not have to be. Downloading directly from here gets you a one-time purchase of $39 — the app, the CLI, every current feature and every future update, no account and no cloud. The Mac App Store version also offers $19 per year or $3.99 per month if you would rather not commit up front. Either way you can try everything free for 14 days first.
What happens to my comments when the document changes?
Remark re-anchors comments to the correct text after edits. If the original text is gone entirely, the comment is marked as orphaned so nothing gets lost.