Org Reminders
Table of Contents
Overview
I use Reminders on my iPhone or iPad for daily to-dos, but Emacs org mode on my computer. This makes switching between the two applications uncomfortable.
Org mode is a powerful tool for editing and managing to-do lists on a computer. Apps like beorg allow you to edit and sync Org mode files on mobile devices. You can use it to get a familiar experience on computers and mobile devices.
But I think Reminders offers a simpler, more intuitive mobile experience. I'm building an Emacs plugin to sync to-dos between Org mode and Reminders.
Thanks reminders-cli to provide a simple and good performance CLI tool for interacting with macOS reminders.
Because I needed specific features, I forked it to ginqi7@reminders-cli.
Thanks jdtsmith provide great ideas for true sync logic. this is the discuss.
Design
Project Structure
There are two components:
- org-reminders-cli : A controller for monitoring the org mode file and Reminders. When changes occur in the org mode file or Reminders, it compares the differences between them, updates Reminders, or sends messages to Emacs.
- org-reminders elisp : A frontend that receives messages from org-reminders-cli and updates the org mode file.
Message Format
[time][target][type][action][id][base64(data)]
[2025-03-18 07:56:32 +0000][Org Mode][CommonList][Update][C8BA491B-2D02-4248-AAA6-46AE9BC8BF30][ewogICJpZCIgOiAiQzhCQTQ5MUItMkQwMi00MjQ4LUFBQTYtNDZBRTlCQzhCRjMwIiwKICAidGl0bGUiIDogIuWPr+S7peWQl++8nyIKfQ==]