Show HN: Remarc – contextual feedback for coding agents via MCP

Uh oh!

There was an error while loading. Please reload this page.

Notifications You must be signed in to change notification settings

Fork 1

Star 30

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

22 Commits

22 Commits

.claude

.claude

.github

.github

app

app

assets

assets

docs-site

docs-site

docs

docs

extension

extension

mcp

mcp

scripts

scripts

spikes

spikes

tests

tests

tools

tools

website

website

.gitignore

.gitignore

.gitleaks.toml

.gitleaks.toml

AGENTS.md

AGENTS.md

CHANGELOG.md

CHANGELOG.md

CLAUDE.md

CLAUDE.md

CONTRIBUTING.md

CONTRIBUTING.md

DESIGN.md

DESIGN.md

ExportOptions.plist

ExportOptions.plist

LICENSE

LICENSE

README.md

README.md

RELEASING.md

RELEASING.md

SECURITY.md

SECURITY.md

THIRD-PARTY-NOTICES.md

THIRD-PARTY-NOTICES.md

Repository files navigation

Remarc is the feedback layer between you and your coding agent. Point at anything on your Mac: text, a screenshot, or a web element. Talk through a review or jot down a quick note. Remarc keeps the relevant context with each comment so your agent can take it from there.

remarc-hero-web.mp4

How it works

1. Comment on anything

Remarc runs from the menu bar, ready whenever you spot something worth changing. Comment on selected text, screenshots, web elements, or speak your feedback. Remarc keeps the original selection, screenshot, web context, or recording with your note, so your agent works from what you saw instead of a paraphrase.

Text comments

Select text in any app and attach a comment to that exact selection. Remarc saves the quote and source app with your note. The text comments guide covers the tooltip, keyboard shortcut, and app exclusions.

Screenshot comments

Grab any region of the screen, adjust the selection, then add arrows, shapes, text, counters, blur, or pixelation. The screenshot stays attached to the comment, and you can reopen it to add or edit annotations. Read about screenshot capture and annotation and redaction.

Web element comments

The companion Chrome extension captures the page URL, selected element or page region, CSS, layout, accessibility data, and React component details when available. The captured web context stays with the comment. Installation and capture shortcuts are in the extension guide.

Voice comments and Crit Mode

On macOS 26 or later, dictate one comment or record a longer review in Crit Mode. Crit Mode transcribes the recording and splits it into separate comment cards. Apple Speech, WhisperKit, and Parakeet all run transcription on your Mac.

Quick Notes

Open a Quick Note when there is nothing to select or capture. It creates a standalone comment for a thought, task, or piece of feedback.

1. Your agent picks up the comments

Comments land in a session. Once you connect an agent, it can read each one with the attached context and work through the list. You do not have to rebuild that context in a separate prompt.

Sessions keep each review together

Group comments into sessions by review, project, or agent conversation. The permanent Inbox catches anything you do not file elsewhere, and connected agents can create sessions for their own conversations.

MCP and plugins carry the context

Claude Code and Codex connect through plugins, Cursor is configured by the app, and Claude Desktop or another MCP client can connect manually. Every supported client gets the same context and MCP tools for reading comments, managing sessions, and resolving work. The agent integrations guide covers each setup path.

Statuses close the loop

Each comment can move through Open, Handed Off, In-Progress, and Resolved. Agents can update the status as they work and leave a resolution summary when they finish. Deleted comments go to searchable History instead of disappearing.

Copy, export, or automate the handoff

Copy a session into an agent prompt, paste it into the app you are using, or export it as Markdown or JSON with control over references and metadata. You can also send comment events to automation tools through webhooks.

Local until you hand it off

Comments and screenshots stay on your Mac unless you hand them to an agent or send them through a webhook you configured. There are no accounts or telemetry. The data and privacy guide explains what is stored and which features use the network.

Documentation

Read the full Remarc documentation for setup and feature guides. Useful starting points include installation, permissions, agent integrations, keyboard shortcuts, and troubleshooting.

Install

Download the latest signed and notarized build:

remarc.app/download

or grab Remarc.zip from GitHub Releases

Install the companion Chrome extension for web context in Chrome and other Chromium browsers.

Requires macOS 14.0 (Sonoma) or later. The app updates itself via Sparkle.

Build from source

Prerequisites: Xcode 26 or later.

git clone https://github.com/metedata/Remarc.git cd Remarc/app xcodebuild build -workspace Remarc.xcworkspace -scheme Remarc \ -configuration Debug -derivedDataPath "$(pwd)/DerivedData" open DerivedData/Build/Products/Debug/Remarc.app

Release builds are signed with a Developer ID certificate and notarized through the release workflow; see RELEASING.md.

Repository layout

Path Contents

app/ The macOS app (SwiftUI + AppKit, Swift 6)

mcp/ Vendored MCP server artifact + agent skill, bundled into the app

extension/ Chrome extension for web page context

website/ remarc.app site and launch router (Cloudflare Workers + static assets)

docs-site/ docs.remarc.app end-user documentation (Astro Starlight)

docs/ Design docs and historical planning notes

The MCP server's source of truth lives in the remarc-agent-plugins repository, which also hosts the Claude Code and Codex plugins. This repo vendors the built artifact.

Tech stack

Swift 6, SwiftUI + AppKit, Sparkle for updates, WhisperKit and FluidAudio for on-device transcription, KeyboardShortcuts, and the Model Context Protocol for agent integrations.

Contributing

See CONTRIBUTING.md. Bug reports and pull requests are welcome.

Support

If Remarc is useful to you, you can Buy Me a Coffee to support its continued development. Remarc remains free and open source.

Security

To report a vulnerability, please see SECURITY.md. Do not open a public issue for security problems.

License

Remarc is released under the MIT License.

The Remarc name, logo, and app icon belong to Metedata LLC and are not covered by the MIT license. Third-party software notices are listed in THIRD-PARTY-NOTICES.md. If you distribute a fork, ship it under a different name and icon.

Topics

Resources

Readme

MIT license

Contributing

Contributing

Security policy

Security policy

Activity

Stars

30 stars

Watchers

0 watching

Forks

1 fork

Report repository