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
No-Code Persistent Memory System for Claude Using Notion and MCP
A radiologist built a 'Cognitive Hub' in Notion that Claude reads and writes to through MCP, creating a structured knowledge base with a routing table to load only relevant information per conversation. The system has grown to 70+ pages after a month of daily use.
CostHawk Launches Public Leaderboard for Claude Code, Codex, and Cursor Token Consumption
CostHawk’s leaderboard ranks public users of Claude Code, OpenAI Codex, and Cursor by total token consumption, tracking counts, models, and sync timestamps without storing prompts or code.
Storybloq: A Project Tracker Living in Your Repo's .story/ Directory Now Has a Mac App
Storybloq, a project tracker that stores tickets, issues, roadmap phases, and session handovers as JSON/markdown inside .story/ in your repo, now has a free Mac app on the App Store. It integrates with Claude Code via CLI and MCP server, and was built entirely using Claude Code.
Open-source memory system for LLM agents achieves high benchmark scores
A persistent memory system for Claude Code and OpenClaw provides LLM agents with context continuity across sessions, achieving 90.8% on LoCoMo and 89.1% on LongMemEval benchmarks. The adapter-based architecture works with any agent framework.