Install
macOS 14+ · Apple silicon

Leave comments in any Mac app

Mark a PDF passage, a sentence on the web or a line of code. Ask Claude or ChatGPT about it right there.1

Free for 14 days. No account needed. A license is $19 once, available in the US during the beta.

A code editor. The outline glides down to line 42, a dot drops at its end and the note keeps the line.

Two notes on one lease. After the PDF closes, choosing “Check the rent increase” in Margem opens page 3 at clause 7.3.

A highlighted clause with its note open. A question is typed, Ask is pressed and an example answer from Claude arrives in the card.

A recipe page. The pointer clicks the end of a paragraph, a dot drops there, a card opens and a note is typed and posted. Then an older note on the photo opens, with an attachment.

A video at 1:23. Control, Option and M drop a dot on the frame and the note keeps the moment.

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

  • Safari
  • Chrome
  • Aside
  • VS Code
  • Preview
  • Finder
  • YouTube

How to leave a note in a Mac app

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.

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.

Select and click +Right-click menu

Write or ask

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

MarkdownAttachments@ChatGPT

It comes back

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.

Stop pasting screenshots into a chat window. Ask about it right where it is.

Spotlight illustration. Searching for “migration” finds two notes from Margem.

Find a saved note from Spotlight or the menu bar

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.

The comments page

Every note grouped by site, file or app, each with a way back to its spot.2

Markdown and files in the card

Lists and bold show their style as you type. Drop a file or a picture in, and Margem keeps a copy.

Out of the way in full screen

When a game, a film or slides fill the screen, Margem hides there. Hidden notes send one notice a day.

Two Shortcuts actions

Comment here starts comment mode. Comments for later opens the saved ones.

Attachments with Quick Look

A click opens the file in Quick Look. The picture Claude was sent sits on its answer.

Claude answers inside the note.

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

Animation: a question in a note, then what goes with it (the clause and the text around it, a picture of the window), then an example answer from Claude.
Lease agreement · 7.2Example answer, written for this page.

Start a note without leaving the app you’re in.

  • ⌃⌥MPress ⌃⌥MOver a button, a line or an image.
  • Select some textThen click the small + that appears.
  • Use the screen’s edgeClick the + on the thread at the right.

Says when a spot is gone

A dashed dot marks a note that lost its place. Its card shows what was there.

Off the words

On a passage, the highlight goes under the words, and the dot never covers them.

Dots, labels or a column

Pick how notes show up in each app, or hide them in that app.

Your accent, your Finder tags

Dots take the Mac’s accent color, or the color of a Finder tag you pick.

You leave the note. Claude writes back on the same spot.

Your AI agent can read your notes and reply.

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.

Animation: a passage in a document gets its highlight, a comment card opens beside it, a question is typed, Ask is pressed and Claude’s answer appears in the card.
Ask 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

Which apps can Margem reopen?

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.

The dashed dot

What you see when a spot is gone

Will a note always come back?
Not every note finds its spot again. When a page changes too much, Margem says so and shows you what was there.

Just you

Notes have one author

Front tabs

Read in each window

Apple silicon

macOS 14 or later

English + Portuguese

Follows your Mac’s language

Asking needs an AI on this Mac

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.

One Mac at a time

Notes live in one file on this Mac. Your other Mac doesn’t see them yet, and nobody else sees them at all.

Your comments live in one file on your Mac.

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.

Margem’s folder

~/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 change
  • anexos/a copy of each attachment
  • entrada/requests from the margem command
  • relatorio.jsonleach try at finding a spot again

Sign-in stays with each AI

Margem keeps no password or key. Each AI uses the account you already have.

Out only when you press Ask

It carries the spot, the text around it and, if allowed, a picture of the window.

One permission to grant

Accessibility, turned on by you in System Settings, lets Margem read the spot.

Screen Recording is optional

Without it, Margem skips the picture when it looks for a spot again.

Install Margem on your Mac

macOS 14 or later · Apple silicon · English and Portuguese

curl -fsSL https://github.com/gabrielmouallem/margem-releases/releases/latest/download/install.sh | sh

The command verifies the published archive, puts Margem in Applications, and opens it. Read the installer

Install with Claude Code
Show me the command and help me install Margem on this Mac: curl -fsSL https://github.com/gabrielmouallem/margem-releases/releases/latest/download/install.sh | sh

If you downloaded the ZIP

  1. Unzip the file, drag Margem into Applications, and open it.
  2. This beta is not yet notarized. If macOS asks for confirmation, open System Settings › Privacy & Security and review the message for Margem.

Make your first note

In the welcome window, enable Accessibility so Margem can find the spot under your pointer. Screen Recording is optional.

Point at a passage, press ⌃⌥M, and write. Your 14 days start when you first open the app.

Free for 14 days. Then $19, once.

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.

  • Pinned notes in any Mac app
  • Claude or ChatGPT inside your note
  • Search in Spotlight or the Margem panel
  • A license key that works offline

US beta only. Your license key arrives by email within one day. Purchases from other countries are refunded.

Pay on Stripe

Checkout runs on Stripe’s own page. Margem never sees your card.

Get your key by email

During the beta, each key is sent by hand, within a day. It has no name or email in it.

Click the link, or paste the key

The link in the email opens Margem with the key. Or paste it in Settings › License. It works offline.

Questions about Margem for Mac

How is this different from a screenshot or a note?
A screenshot freezes a copy, and a note needs words like “the second paragraph”. Margem pins the note to the spot itself, in the app you were using, so it can show it there again.
Will it read my screen?
It reads the spot you point at through Accessibility, which you turn on in System Settings. Screen Recording is optional; without it, Margem finds spots by their words and their place, with no picture.
Will a note always come back?
Often, not always. Margem keeps the words around the note and the page or file, and looks for the spot whenever it’s on screen. When it can’t find it, a dashed dot says so, the card shows what was there, and “Show the new spot” lets you point at it again.
Do I need Claude or ChatGPT?
Only to ask. Notes work without any AI. Asking uses Claude Code or Codex, signed in on this Mac with your own account, and Margem keeps no password or key.
Where are my notes, and who can see them?
In one file in your Library folder, under Application Support, with copies of your attachments beside it. Margem has no sharing, so nobody else sees them, and a question leaves the Mac only when you press Ask, to the AI you picked. Spotlight’s index stays on this Mac too.
Will it get in the way?
In full screen, Margem hides on that screen until you leave it, and ⌃⌥M brings it back there. You can also hide it in any app, and a notification tells you when notes wait on a page you hid it from.
What does it cost?
$19, once, after a 14-day free trial with everything on. No subscription and no account. When the trial ends, your notes stay and still open; new notes and questions wait for a key. During the beta, it is sold in the United States only.
My Mac says it can’t check Margem. What do I do?
Apple has not notarized this beta yet. When you first open the ZIP version, review the Margem prompt in System Settings › Privacy & Security. See installation instructions.
How do I uninstall it?
Quit Margem from its menu, then drag it from Applications to the Trash. Your comments stay in a folder, ~/Library/Application Support/Margem, until you delete it too. The install line wrote nothing else.
Which Macs does it run on?
macOS 14 or later, on a Mac with Apple silicon. On macOS 26 and later the card and the panel use Liquid Glass; earlier versions use the system’s frosted material.

Every book has a margin. Now your Mac does too.