View on GitHub

Reminders

DuckTape provides powerful natural language capabilities for managing your Apple Reminders. This guide explains how to create, manage, and organize reminders using DuckTape's intuitive interface.

Note: DuckTape integrates with Apple's Reminders app, allowing you to access and modify your reminders both through the command line and the standard macOS interface.

Reminder Features Overview

Create Reminders

Create time-sensitive or date-specific reminders with natural language.

Manage Lists

Organize tasks into different reminder lists for better organization.

Recurring Reminders

Set up recurring reminders for regular tasks and habits.

Priority Levels

Assign priority levels to distinguish important reminders.

List and Search

Find, filter, and view your reminders by date, list, or status.

Complete Tasks

Mark reminders as complete or check off items from your lists.

Creating Reminders

You can create reminders using natural language commands. DuckTape will interpret your intent and create a reminder with the appropriate details.

Terminal
$ ducktape remind me to buy milk tomorrow morning
Creating reminder: "Buy milk" for tomorrow at 9:00 AM...
Reminder created successfully!
$ |

Reminder Command Patterns

DuckTape understands various command patterns for creating reminders:

Pattern Example Result
remind me to [task] "remind me to call John" Creates a reminder with the task "Call John"
remind me to [task] at [time] "remind me to take medicine at 8pm" Creates a timed reminder for 8:00 PM today
remind me to [task] on [date] "remind me to pay rent on April 1st" Creates a reminder for the specified date
remind me to [task] every [recurrence] "remind me to water plants every Tuesday" Creates a recurring reminder for Tuesdays
add [item] to [list] list "add milk to shopping list" Creates a reminder in the specified list

Reminder Details

You can specify various details when creating a reminder:

You can specify when a reminder is due using natural language date and time expressions:

  • Specific times: "remind me to call John at 3pm"
  • Relative times: "remind me to check email in 30 minutes"
  • Specific dates: "remind me to pay bills on March 15th"
  • Relative dates: "remind me to follow up next Monday"
  • Date and time: "remind me about the meeting tomorrow at 9am"

Set priorities to distinguish important reminders:

  • High priority: "add high priority reminder to submit report"
  • Medium priority: "remind me with medium priority to call back client"
  • Low priority: "add low priority task to clean garage"

DuckTape maps priorities to Apple Reminders' flag system, making them visible in the native app.

Organize your reminders by specifying which list they belong to:

  • Add to list: "add milk to grocery list"
  • Create in list: "create a reminder in my work list to call client"
  • Specify list: "remind me in personal list to call mom tomorrow"

If you don't specify a list, DuckTape will use your default reminder list (configurable via environment variables).

Create recurring reminders for routine tasks:

  • Daily: "remind me to take medication every day at 9am"
  • Weekly: "remind me to water plants every Monday and Thursday"
  • Monthly: "remind me to pay rent on the 1st of every month"
  • Custom: "remind me to backup files every other Friday"

Managing Reminders

Viewing Reminders

You can view your reminders using natural language commands:

# Show all reminders
ducktape show all reminders

# Show reminders for a specific date
ducktape show reminders for today
ducktape show reminders for tomorrow
ducktape show reminders for next week

# Show reminders from a specific list
ducktape show reminders from grocery list

# Show reminders by status
ducktape show completed reminders
ducktape show overdue reminders

Here's an example of viewing reminders:

Terminal
$ ducktape show reminders for today
Today's Reminders:
1. [9:00 AM] Buy milk
2. [2:00 PM] Team meeting
3. [5:30 PM] Pick up dry cleaning
$ |

Completing Reminders

Mark reminders as complete when you've finished the task:

# Complete a reminder by description
ducktape complete reminder "buy milk"

# Complete a reminder by ID (shown when listing reminders)
ducktape complete reminder 3

# Complete multiple reminders
ducktape complete reminders "buy milk" and "call mom"

Updating Reminders

Modify existing reminders with natural language:

# Change the due date
ducktape update reminder "team meeting" to tomorrow

# Change the title
ducktape rename reminder "buy milk" to "buy almond milk"

# Change both title and date
ducktape change reminder "dentist" to "doctor appointment" on Friday

# Add notes to a reminder
ducktape add note "bring documents" to reminder "doctor appointment"

Deleting Reminders

Remove reminders you no longer need:

# Delete a specific reminder
ducktape delete reminder "buy milk"

# Delete all completed reminders
ducktape delete completed reminders

# Delete all reminders from a list
ducktape delete all reminders from grocery list

Managing Reminder Lists

Organize your reminders into different lists for better task management:

# Create a new list
ducktape create reminder list "Work Projects"

# Show all lists
ducktape show reminder lists

# Rename a list
ducktape rename reminder list "Work" to "Work Tasks"

# Delete a list
ducktape delete reminder list "Old Tasks"

Natural Language Examples

Here are some examples of natural language commands for working with reminders:

Basic Reminders
  • "Remind me to call mom tonight"
  • "Create a reminder to submit expense report"
  • "Add buy groceries to my to-do list"
Timed Reminders
  • "Remind me to check email at 9am"
  • "Set a reminder for the meeting at 2pm tomorrow"
  • "Remind me to call client in 30 minutes"
List-Specific Reminders
  • "Add milk and eggs to my grocery list"
  • "Create a work reminder to follow up with team"
  • "Add quarterly planning to projects list"
Recurring Reminders
  • "Remind me to take medication every day at 8am"
  • "Set up a weekly reminder to submit timesheet on Fridays"
  • "Remind me to water plants every Tuesday and Saturday"
Managing Reminders
  • "Show me all my reminders for today"
  • "Mark the grocery shopping reminder as complete"
  • "Delete the dentist appointment reminder"
Advanced Usage
  • "Move all grocery items to shopping list"
  • "Show me all high priority reminders"
  • "Reschedule my dentist appointment to next Tuesday at 2pm"

Integrating with Apple Reminders

All reminders created with DuckTape sync with the Apple Reminders app, allowing you to:

  • View and edit reminders from any Apple device
  • Receive standard macOS notifications for reminders
  • Use Siri to interact with reminders created by DuckTape
  • Access reminders through the macOS Notification Center

Pro Tip

Using a combination of DuckTape and the Apple Reminders app gives you the best of both worlds:

  • Quick creation with natural language through DuckTape
  • Visual organization and editing through Apple Reminders
  • Access to all Apple ecosystem features like sharing and location-based reminders