Remark: A Markdown Annotation Tool for Claude Code Workflows

What Remark Does

Remark addresses a specific friction point when using Claude Code: reviewing spec or instruction files and leaving feedback for the agent. The developer behind it found that pasting notes into chat disconnects feedback from the file, while leaving notes directly in markdown is messy because the agent either reads them as content or strips them.

Key Features and Commands

The tool is a native macOS application with these specific capabilities:

• Annotate any Markdown file inline by highlighting sections and adding comments
• Export annotations with remark export file.md - this generates a JSON list containing exactly what was flagged, where in the file, and the surrounding context
• Clear resolved annotations with remark resolve
• Local-only operation - nothing leaves your machine

Claude Code Integration

The Claude Code integration works through a skill system:

• Run remark install-skill to install a skill in your .claude/skills/ directory
• The skill covers the annotation format, including how to read exports, how to mark annotations resolved, and how to handle partial matches when the file has changed since review

Technical Details

The tool was built with Claude Code, which wrote most of the Rust backend and the re-anchoring algorithm. It's available for macOS with a 7-day free trial, then a $17 one-time purchase. Installation options include:

• Direct download from getremark.app
• Homebrew: brew install mfreiwald/tap/remark

This type of tool is useful for developers who regularly review and provide feedback on Claude Code instruction files, offering a structured way to maintain feedback context within the actual files being reviewed.