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
Tilde.run: An Agent Sandbox with a Transactional, Versioned Filesystem
Tilde.run provides isolated, reversible sandboxes for AI agents, with a versioned filesystem that mounts GitHub, S3, and Google Drive, and network isolation by default.
PocketTeam: A Claude Code Pipeline with Hook-Based Safety and Learning Agents
PocketTeam is a Claude Code pipeline that implements 9 safety layers at the tool-call level to block dangerous operations like writes to .env or rm -rf commands. The system includes an Observer agent that analyzes completed tasks and writes structured learnings to improve future agent performance.
OpenClaw User Critiques Tool's Architecture and Safety Gaps
A Reddit user describes OpenClaw as the only tool making agent automation this accessible but criticizes its architecture for lacking a control layer for file operations, a protected kernel, proper context management, and built-in versioning or tests.
ClamBot: AI Agent Runs LLM-Generated Code in WASM Sandbox for Security
ClamBot is an AI agent framework that executes all LLM-generated code in a WebAssembly sandbox using QuickJS in Wasmtime, eliminating the need for exec() or subprocess calls. It includes an approval gate for tool calls, persistent script caching as 'clams', and supports multiple LLM providers.