lucasbento / reminders-cli

Command-line interface to interact with the Reminders.app

reminders-cli

Command-line interface that uses natural language processing to parse phrases and interact with Reminders.app.

Getting started

TLDR: run npm i -g reminders-cli and reminders --help.

Usage

$ reminders --help

  Usage
    $ remind <input>
    $ reminders
  
  Options
    --list      - List all reminders (will trigger if no option is provided).
    --complete  - List all reminders and enable a selector to be completed

  Examples
    $ remind me to feed the cats tomorrow at 12:00
    $ reminders --list

Create

$ remind me in two hours to study

You can see some examples in the date parsing test file.

List

$ reminders --list

Complete

$ reminders --complete

🔥 It's also possible to provide a name (or part of) to complete command:

Installation

This package requires NodeJS to be installed.

Homebrew

brew install node

Manual

Go to https://nodejs.org/en/download/ and install the latest LTS version.

Installing the package

npm install -g reminders-cli

Development

1. Install

yarn # or npm install

2. Run build with auto-reloading

yarn run watch

3. Try commands

node ./dist/index.js --list # To list reminders
node ./dist/index.js --add "My reminder" 11/11/2017 10:30
node ./dist/index.js --add "My reminder"

reminders-cli's Issues

Same name as another reminders cli

Was about to install this, but realized it has the same name as another reminders cli:

https://github.com/keith/reminders-cli

Any recommendations so I can use both?

In particular, the reminders command. I think renaming the other one would make sense?

Times out

On a couple of computers, one El Capitan, one Sierra, I get an AppleScript timeout on both.

script:64:109: execution error: Reminders got an error: AppleEvent timed out. (-1712)

Is there a way to fix this or extend the timeout?

When I add a time it gets added as 12:00am on 10.15.5

My reminders were upgraded as part of the 10.15.5 install. Did not use this tool before that.