Mac guide

Keep a notebook as a folder on your Mac

Remindly for Mac can keep a notebook as a folder of Markdown files and update them as you write, so Claude Code and other agents that read files always see your latest notes. The files are copies: your notes stay in Remindly.

  • 3 minutes
  • Works on Mac
  • Remindly Pro
  • Remindly for Mac

Mirror a notebook

The folder mirror is in Remindly for Mac, on Remindly Pro.

  1. Open Remindly → Settings… (⌘,) and choose Folders.

  2. Click Add Mapping….

  3. Pick a Notebook, then click Choose… and pick a folder.

    An empty folder is simplest. Locked notebooks aren't offered, because their notes would be written to disk unencrypted.

  4. Click Add Mapping.

    Remindly writes the files. The mapping reads Up to date with the number of notes when it's done.

Add as many mappings as you like, one notebook to one folder each. On a mapping, Show in Finder opens its folder, Pause stops the updates until you click Resume, and Remove… ends the mapping and leaves the files where they are. Mirror Now brings every folder up to date right away.

What's in the folder

  • A .md file for each note, named after its title. A second note with the same title is Title 2.md.
  • A subfolder for each sub-notebook, all the way down.
  • Titles that end in .md are the whole file name. A note titled SKILL.md or CLAUDE.md is written under exactly that name.
  • An _attachments folder with copies of the images and files the notes link to. Remindly downloads the ones this Mac doesn't have yet.
  • Links between notes in the same folder point at the other note's file.
  • _REMINDLY.md at the top tells an agent that finds the folder what it is, that the files are copies, and how to change notes. Remindly rewrites it, and it isn't a note.
  • A hidden .remindly folder holds Remindly's record of what it wrote. Leave it alone.
  • Details at the top of each file, in frontmatter:
--- id: 6f1c0e2a-… title: "Launch plan" notebook: Projects tags: ["q4", "launch"] created: 2026-10-12T18:03:11.000Z updated: 2026-10-20T09:41:00.000Z --- The note, in Markdown…

A note saved from the web also has source_url. Keys you add yourself, such as the name and description a skill needs, are kept when Remindly rewrites the file.

What Remindly keeps current

While Remindly is open on this Mac, a change to a note reaches its file within seconds.

  • Edit a note, on any device, and its file is rewritten.
  • Rename a note and its file is renamed. Notes that link to it are updated.
  • Move a note to a sub-notebook and its file moves to that subfolder. Move it out of the notebook and its file is removed.
  • Move a note to the Trash, or lock it, and its file is removed. Restoring or unlocking it writes the file again.

It's one way. Remindly writes the files and never reads them back. To change a note, use Remindly, or have your agent use the Remindly connector. The id at the top of each file is the note's id there.

If you edit a file

Remindly never overwrites a file that was changed in the folder.

  • An edited file is left alone. It stops getting updates, and Remindly writes its own version next to it as Title (Remindly).md. Settings → Folders lists the file in orange.
  • Delete the edited file to get updates again. Remindly's version takes the note's own name.
  • The edit doesn't change the note. Neither does renaming, moving or deleting a file: Remindly writes the note's file again.
  • Files you add are left alone. They don't become notes, and Remindly never deletes them.
  • A file that was already there under a note's name is treated like an edited one.

Folders an agent reads as instructions

You can mirror a notebook into a folder an agent loads by itself, such as Claude Code's .claude/skills or its memory folder. Your skills and memory are then notes you can edit on your iPhone. A skill is a sub-notebook named after it, with a note titled SKILL.md inside.

Add Mapping has a switch for this, An agent reads this folder as instructions. Remindly turns it on when the folder looks like one (a path with .claude, .cursor, .codex, skills or memory in it, or a folder that holds a CLAUDE.md, AGENTS.md or SKILL.md), and won't mirror into such a folder with it off.

Every note that lands in that notebook becomes a file the agent reads and follows. Notes arrive from outside too: email to Remindly, the share sheet, the Web Clipper, Granola meetings and Shortcuts. Use a notebook that nothing else writes to.

These folders don't get a _REMINDLY.md, because an agent could load it as an instruction.

If something's not right

Add Mapping… is dimmed
The folder mirror is part of Remindly Pro. On Remindly Free, mappings you already made are paused and their files stay as they are. They carry on by themselves when the account is on Pro again.
The files stopped updating
Remindly has to be open on this Mac. Check Settings → Folders too: a mapping can be paused, and a file listed in orange was edited in the folder and is being left alone.
It says the folder can't be opened anymore
The folder was moved or deleted. Remove the mapping and add it again.
Can I edit the files and have the notes change?
No. The mirror only writes out. Change notes in Remindly, or let your agent change them through the connector.
Can I use it with Obsidian?
To read, yes: the folder opens as a vault. Edits made there don't reach your notes. For a copy of everything on any plan, export your notes as Markdown.
Is it on iPhone or iPad?
No. The mirror is in Remindly for Mac. Notes you change on an iPhone reach the folder once the Mac has synced.

More guides

All guides

Use your notes in Claude and ChatGPT

Add Remindly as a connector so Claude or ChatGPT can search your notes, read them, add to them and set reminders. You sign in once, and you can disconnect from Settings.

ClaudeChatGPT

Keep your AI skills in a note

Write a skill once as a Remindly note, and Claude or ChatGPT can read it and run it. The example checks whether AI assistants can read and quote your home page.

ClaudeChatGPT

New Note on your Lock Screen

Put a New Note button in a corner of your Lock Screen. Press and hold it, and Remindly opens to a blank note.

iPhone

New to Remindly? Start in a minute.

Create a free account, then sign in on your iPhone, iPad, Mac or the web.