Point and press ⌃⌥M
Rest the pointer on a button, an image or a line, or select a passage. A dot lands right there and the card opens, ready to type.
Mark a PDF passage, a sentence on the web or a line of code. Ask Claude or ChatGPT about it right there.1
No account needed. A license is $19 once, available in the US during the beta.
Point at a passage and click. Write, press Enter. Then open an older note from its dot.Two notes on the same PDF. Close it, then open “Check the rent increase” to return to clause 7.3.Press ⌃⌥M over a video. The note keeps the moment, and opens the video at 1:23.Point at a line in VS Code or Cursor and press ⌃⌥M. The note keeps line 42 and opens the file there.Type a question in the note and press Ask. This answer was written for this page.1
Pins notes inside the apps you already use
Margem lives in the menu bar. Turn on Accessibility in System Settings so it can recognize the text or button you point at. Screen Recording is optional and lets Margem use an image to find the spot again.
Rest the pointer on a button, an image or a line, or select a passage. A dot lands right there and the card opens, ready to type.
Type and press Enter to keep the note. Or press Ask, and Claude or ChatGPT answers inside the card, about the spot you chose.1
Margem looks for the spot whenever it’s on screen again, even after a restart. When the spot is gone, a dashed dot says so and shows what was there.
Type a word from any note in Spotlight, or open the comments page in the menu bar. One click opens the page at the passage, the code at the line, the video at the minute.
Lists and bold show their style as you type. Drop a file or a picture in, and Margem keeps a copy.
When a game, a film or slides fill the screen, Margem hides there. Hidden notes send one notice a day.
Comment here starts comment mode. Comments for later opens the saved ones.
A click opens the file in Quick Look. The picture Claude was sent sits on its answer.
Press Ask and Claude’s answer arrives in the card, under your note. Ask ChatGPT for a second opinion and it reads the whole thread before answering below.1
Lease agreement · 7.2Example answer, written for this page.A dashed dot marks a note that lost its place. Its card shows what was there.
On a passage, the highlight goes under the words, and the dot never covers them.
Pick how notes show up in each app, or hide them in that app.
Dots take the Mac’s accent color, or the color of a Finder tag you pick.
Margem comes with a margem command for agents that work in a terminal, and a skill for Claude Code you install from Settings. Ask your agent to look at your comments, and it replies right in the card.
# inside the app: Margem.app/Contents/Helpers/margem
margem list # your open comments
margem show 3f9a2c1b # the spot in layers and the messages
margem reply 3f9a2c1b "Run it first."
margem later 3f9a2c1b # keep it for later
margem resolve 3f9a2c1b # mark it resolved
margem list --json # the same, for a program# Settings › Claude Code › Skill › Install
~/.claude/skills/margem/SKILL.md
name: margem
allowed-tools: Bash(…/Margem.app/Contents/Helpers/margem *)
# then, in Claude Code (an example):
> look at my Margem comments
margem list
margem show 3f9a2c1b
margem reply 3f9a2c1b "…"margem show 3f9a2c1b --json # the layers a question carries
{
"ondeFica": "Deploy › Steps",
"escolhido": "Run the migration before you deploy the API.",
"textoEmVolta": "… »Run the migration …« …",
"mensagens": [{ "autor": "Você", "texto": "Does the order matter here?" }]
}
# with Screen Recording on, a picture of the window goes too# in the card, start a message with @ChatGPT or @Claude
@ChatGPT is there a safer order?
# Margem runs the Codex on this Mac, read-only,
# with the account you already use there.
# No Codex in the terminal? The copy inside the ChatGPT app works.In Margem 0.27, notes can return to a passage in Safari, Chrome or Aside, a PDF page in Preview, a video time on YouTube or a code line in VS Code or Cursor. In other apps the target depends on what macOS can read.
What you see when a spot is gone
Not every note finds its spot again. When a page changes too much, Margem says so and shows you what was there.
Notes have one author
Read in each window
macOS 14 or later
Follows your Mac’s language
Ask uses Claude Code or Codex, signed in with your own account. Without them, Ask opens the Claude or ChatGPT app with the question already written.
Notes live in one file on this Mac. Your other Mac doesn’t see them yet, and nobody else sees them at all.
Margem keeps them in your Library folder, next to other apps’ data. A question goes out only when you press Ask, and only to the AI you picked.
~/Library/Application Support/Margem/The copy Spotlight keeps stays on this Mac too, and one switch in Settings takes your comments out of it.
fios.jsonyour comments, written whole on every changeanexos/a copy of each attachmententrada/requests from the margem commandrelatorio.jsonleach try at finding a spot againMargem keeps no password or key. Each AI uses the account you already have.
It carries the spot, the text around it and, if allowed, a picture of the window.
Accessibility, turned on by you in System Settings, lets Margem read the spot.
Without it, Margem skips the picture when it looks for a spot again.
macOS 14 or later · Apple silicon · English and Portuguese
Try every feature for 14 days, including Ask. When the trial ends, you can still open your saved notes. A one-time license lets you add new notes and ask more questions.
$19
One payment, for the Macs you use. No subscription.
US beta only. Your license key arrives by email within one day. Purchases from other countries are refunded.
Checkout runs on Stripe’s own page. Margem never sees your card.
During the beta, each key is sent by hand, within a day. It has no name or email in it.
The link in the email opens Margem with the key. Or paste it in Settings › License. It works offline.
~/Library/Application Support/Margem, until you delete it too. The install line wrote nothing else.
The comments page
Every note grouped by site, file or app, each with a way back to its spot.2