{"repo":"coddingtonbear/icloud-md","free":true,"listed":false,"github":"https://github.com/coddingtonbear/icloud-md","clone":"git clone https://github.com/coddingtonbear/icloud-md.git","description":"Your Apple Notes as real Markdown files, on any OS, bidirectionally synced with a `git`-flavored CLI","language":"TypeScript","stars":24,"topics":["icloud","markdown"],"license":"MIT","category":"cli-tools","readme_excerpt":"Apple Notes only lives one place: Notes.app or the iCloud web client. There is no export, API, or any easy way to read or edit your own notes from anywhere else. icloud-md frees them from icloud by turning your Apple Notes into a folder of real Markdown files, on Linux, Windows, or macOS, editable in whatever tool you already use (Vim, VS Code, Obsidian, grep ) and syncs your edits back to iCloud as if you'd typed them into Notes.app all along. - Why - Install - Quick start - Commands - What works today - Where the title lives --defer-renames - Known limitations - How it works - Non-goals - Comparison with other projects Platform & direction Fidelity & content types (read / write) - Reporting bugs Getting a Bug Report Export Reproduction Steps File Identities - Contributing / development - License Why - Your notes become real files — one Markdown file per note, editable, versionable in git, greppable, diffable, scriptable — instead of locked inside Notes.app or the iCloud web client. - Every OS, not just Apple's : icloud-md is a plain Node CLI. Clone your notes to Linux or Windows and treat them like any other folder of text, no Mac required. - Actually bidirectional, not just export : pull and push keep your local folder and iCloud in sync in both directions — edit locally, edit in Notes.app, or edit from another device, and it reconciles. - Built-in version history : Every pull / push that changes a note snapshots it, so you can inspect or roll back any past version of a no","default_branch":null,"files":null,"tree":[],"storefront":"/r/coddingtonbear","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/coddingtonbear/icloud-md/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}