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: about 1 year 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 10 years ago)
- Default Branch: main
- Last Pushed: 2025-02-18T19:02:30.000Z (about 1 year ago)
- Last Synced: 2025-04-07T02:07:26.562Z (about 1 year ago)
- Topics: cli, command-line, macos, osx, reminders
- Language: Swift
- Homepage:
- Size: 84 KB
- Stars: 746
- Watchers: 16
- Forks: 59
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-command-line-apps - reminders-cli - Simple interface for interacting with Reminders. (Mac OS X / World Wide Web)
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)
```
#### Show reminders due on or by a date
```
$ reminders show-all --due-date today
1: Contribute to open source (in 3 hours)
$ reminders show-all --due-date today --include-overdue
0: Ship reminders-cli (2 days ago)
1: Contribute to open source (in 3 hours)
$ reminders show-all --due-date 2025-02-16
1: Contribute to open source (in 3 hours)
$ reminders show Soon --due-date today --include-overdue
0: Ship reminders-cli (2 days ago)
1: Contribute to open source (in 3 hours)
```
#### 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
```