Mirror a notebook
The folder mirror is in Remindly for Mac, on Remindly Pro.
Open (⌘,) and choose Folders.
Click Add Mapping….
-
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.
-
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.mdorCLAUDE.mdis 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:
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.