v3.0.4 — Full feature parity

Apple Reminders
for your terminal

A powerful CLI for Apple Reminders built with Swift. Create, search, and manage reminders without leaving your terminal.

Install Now View Source
100%
Native Swift
<1ms
Response Time
terminal — bash
➜ reminder create "Deploy release" --priority high --due-date tomorrow
✓ Created: ☐ Deploy release
➜ reminder search --tag work
☐ Fix authentication bug #work #urgent
☐ Review PR #234 #work #review
☑ Team standup notes #work
➜
Features

Everything you need

Complete control over your reminders with a CLI designed for power users.

Complete Management

Create, update, complete, and delete reminders with simple commands. Full CRUD operations at your fingertips.

Advanced Search

Filter by priority, dates, tags, URLs, and alarms.

Tag System

Organize with #hashtags that sync across devices.

List Management

Create and organize reminder lists for different contexts.

JSON Output

Machine-readable output for automation with jq.

Statistics

Track productivity metrics and completion rates.

Comparison

CLI vs Reminders App

Why choose the terminal over the GUI?

Feature CLI App
Lightning-fast creation ✓ ✗
JSON/automation support ✓ ✗
Scriptable workflows ✓ ✗
Bulk operations ✓ ✗
Advanced search filters ✓ ✗
iCloud sync ✓ ✓

Built for developers

  • Integrate with shell scripts
  • Pipe output to other tools
  • Automate with cron jobs
  • Version control your workflows
Installation

Get started

Choose your preferred installation method.

bash
brew tap AungMyoKyaw/homebrew-tap && brew install reminder
bash 
# Clone and build
git clone https://github.com/AungMyoKyaw/apple-reminders-cli.git
cd apple-reminders-cli
./install.sh
Note: On first run, grant permissions in System Settings → Privacy & Security → Calendars
Usage

Common commands

Get productive immediately with these essential commands.

command
reminder list
List all reminders
command
reminder create "Buy groceries" --due-date tomorrow
Create with due date
command
reminder stats
View productivity stats
command
reminder create "Fix bug #work #urgent" --priority high
Create with tags & priority
command
reminder complete "Buy groceries"
Mark as complete
command
reminder search --tag work
Search by tag
command
reminder list --json | jq '.[0].title'
JSON output with jq
Shortcuts

Work faster

Priority and date shortcuts for power users.

--priority high
High Priority
--priority medium
Medium Priority
--priority low
Low Priority
--due-date today
Due Today
--due-date tomorrow
Due Tomorrow
--due-date "in 3d"
Relative Dates
--json
JSON Output
--help
Get Help
Reference

Priority levels

Quick reference for priority symbols and values.

!!!
High
1-4
!!
Medium
5
!
Low
6-9
—
None
0
Built With

Native & powerful

Built with Apple's own technologies for seamless integration.

Swift
Native performance
EventKit
Apple's framework
ArgumentParser
CLI framework