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

A simple CLI for interacting with macOS reminders
https://github.com/keith/reminders-cli

cli command-line macos osx reminders

Last synced: 3 months ago
JSON representation

A simple CLI for interacting with macOS reminders

• Host: GitHub
• URL: https://github.com/keith/reminders-cli
• Owner: keith
• License: mit
• Created: 2016-06-27T06:38:51.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-02-15T23:02:19.000Z (4 months ago)
• Last Synced: 2024-02-16T00:21:03.886Z (4 months ago)
• Topics: cli, command-line, macos, osx, reminders
• Language: Swift
• Homepage:
• Size: 71.3 KB
• Stars: 602
• Watchers: 16
• Forks: 51
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars-by-sandeep - reminders-cli
• awesome-command-line-apps - reminders-cli - Simple interface for interacting with Reminders. (Mac OS X / World Wide Web)
• awesome-command-line-apps - reminders-cli - Simple interface for interacting with Reminders. (Mac OS X / World Wide Web)
• awesome-stars - keith/reminders-cli - A simple CLI for interacting with macOS reminders (Swift)

README

        
# reminders-cli

A simple CLI for interacting with OS X reminders.

## Usage:

#### Show all lists

```

$ reminders show-lists

Soon

Eventually

```

#### Show reminders on a specific list

```

$ reminders show Soon

0 Write README

1 Ship reminders-cli

```

#### Complete an item on a list

```

$ reminders complete Soon 0

Completed 'Write README'

$ reminders show Soon

0 Ship reminders-cli

```

#### Undo a completed item

```

$ reminders show Soon --only-completed

0 Write README

$ reminders uncomplete Soon 0

Uncompleted 'Write README'

$ reminders show Soon

0 Write README

```

#### Edit an item on a list

```

$ reminders edit Soon 0 Some edited text

Updated reminder 'Some edited text'

$ reminders show Soon

0 Ship reminders-cli

1 Some edited text

```

#### Delete an item on a list

```

$ reminders delete Soon 0

Completed 'Write README'

$ reminders show Soon

0 Ship reminders-cli

```

#### Add a reminder to a list

```

$ reminders add Soon Contribute to open source

$ reminders add Soon Go to the grocery store --due-date "tomorrow 9am"

$ reminders add Soon Something really important --priority high

$ reminders show Soon

0: Ship reminders-cli

1: Contribute to open source

2: Go to the grocery store (in 10 hours)

3: Something really important (priority: high)

```

#### See help for more examples

```

$ reminders --help

$ reminders show -h

```

## Installation:

#### With [Homebrew](http://brew.sh/)

```

$ brew install keith/formulae/reminders-cli

```

#### From GitHub releases

Download the latest release from

[here](https://github.com/keith/reminders-cli/releases)

```

$ tar -zxvf reminders.tar.gz

$ mv reminders /usr/local/bin

$ rm reminders.tar.gz

```

#### Building manually

This requires a recent Xcode installation.

```

$ cd reminders-cli

$ make build-release

$ cp .build/apple/Products/Release/reminders /usr/local/bin/reminders

```