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

Command-line interface to interact with the Reminders.app
https://github.com/lucasbento/reminders-cli

cli mac macos nodejs osx reminders terminal

Last synced: 8 months ago
JSON representation

Command-line interface to interact with the Reminders.app

• Host: GitHub
• URL: https://github.com/lucasbento/reminders-cli
• Owner: lucasbento
• Created: 2017-08-08T12:05:31.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-01T02:46:58.000Z (over 3 years ago)
• Last Synced: 2025-03-10T07:07:51.664Z (8 months ago)
• Topics: cli, mac, macos, nodejs, osx, reminders, terminal
• Language: JavaScript
• Homepage:
• Size: 749 KB
• Stars: 92
• Watchers: 1
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
 





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

```console

$ reminders --help

  Usage

    $ remind 

    $ 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

```console

$ remind me in two hours to study

```

![Add command](media/add_command.gif "Add command")

> You can see some examples in the [date parsing test file](https://github.com/lucasbento/reminders-cli/blob/master/src/utils/__tests__date.spec.js#5).

### List

```console

$ reminders --list

```

![List command](media/list_command.gif "List command")

### Complete

```console

$ reminders --complete

```

![Complete command](media/complete_command.gif "Complete command")

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

![Complete command](media/complete_with_arg_command.gif "Complete command")

### Installation

This package requires NodeJS to be installed.

#### Homebrew

```console

brew install node

```

#### Manual

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

### Installing the package

```console

npm install -g reminders-cli

```

## Development

1. Install

```console

yarn # or npm install

```

2. Run build with auto-reloading

```console

yarn run watch

```

3. Try commands

```console

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"

```