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-skillto 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.
📖 Read the full source: r/ClaudeAI
👀 See Also
Curated list of 260+ AI agents and tools with open-source and self-hosted focus
A comprehensive GitHub repository lists over 260 AI agents and frameworks, emphasizing open-source, self-hosted, and local-first options including Ollama, OpenClaw, and DeerFlow.
Vigil: A Cryptographic ID System for OpenClaw Agents to Prevent Blocking
A developer running OpenClaw agents has identified that anonymous agent traffic is increasingly being blocked by sites, and proposes Vigil—a sign-in system that gives agents cryptographic IDs to build reputation and avoid indiscriminate blocking.
Ouroboros Adds PM Interview Mode for Claude Code to Bridge Spec Gap
Ouroboros now includes a PM mode that runs a guided interview before handing off to Claude Code, asking questions like what problem is being solved, who it's for, and what constraints matter. The output is a PRD/PM document with goal, user stories, constraints, success criteria, assumptions, and deferred items.
AiPayGen: An AI Agent Marketplace with MCP Integration for Claude Code
AiPayGen is a marketplace with 142 AI agents across 27 categories including finance, legal, healthcare, DevOps, security, and marketing. It functions as an MCP server for direct use in Claude Code, allowing users to browse, invoke, and manage agents through specific commands.