reminders-sync.nvim

A simple wrapper neovim plugin which uses https://github.com/keith/reminders-cli to allow pulling reminders to a certain directory, and editing them, while automatically pushing to macOS Reminders app.

Installation:

Through any package manager but I use vimplug

Plug 'Okerew/reminders-sync'

Setup:

require("reminders-sync").setup({
    -- all optional, these are the defaults:
    dir              = "$HOME/.reminders", -- where you want to have the reminders
    bin              = "reminders",        -- path to reminders cli 
    poll_interval_ms = 30000,              -- 30 s background pull
    auto_poll        = true,
})

Example:

-- Each list maps to a file: $HOME/.reminders/<ListName>.md
-- File format:
--
--   # ListName
--
--   - [ ] Buy milk
--   - [x] Write README
--     > Remember to include the installation section
--     > (second line of note)
--   - [ ] Go to the grocery store ! 2025-06-01 09:00
--   - [ ] Something vague ! tomorrow 9am
--
-- Lines indented with two spaces and starting with "> " are note
-- lines belonging to the reminder directly above them.
--
-- A due date is written at the end of the title line after " ! ".
-- The value is passed verbatim to --due-date so natural strings like
-- "tomorrow 9am" or "2025-06-01 09:00" both work.

Note:

As this obviosly works with the macOS Reminders app it will work only on macOS, though 3rd party apps using the same api will also work.