refactor: remove unsupported hourly option, add README docs

- Remove `hourly` from Recurrence enum (EventKit doesn't support it)
- Remove unused `displayString` property
- Add recurring reminder section to README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tjazerzen

README.md

@@ -72,6 +72,21 @@ $ reminders show Soon
 3: Something really important (priority: high)
 ```
 
+#### Add a recurring reminder
+
+```
+$ reminders add Soon Daily standup --due-date "tomorrow 9am" --repeat daily
+Added 'Daily standup' to 'Soon' (repeats: daily)
+$ reminders add Soon Weekly review --due-date "next friday 3pm" --repeat weekly
+Added 'Weekly review' to 'Soon' (repeats: weekly)
+$ reminders show Soon
+0: Ship reminders-cli
+1: Daily standup (in 10 hours) (repeats: daily)
+2: Weekly review (in 4 days) (repeats: weekly)
+```
+
+Supported values: `daily`, `weekly`, `monthly`, `yearly`
+
 #### Show reminders due on or by a date
 
 ```

Sources/RemindersLibrary/CLI.swift

@@ -155,7 +155,7 @@ private struct Add: ParsableCommand {
 
     @Option(
         name: .shortAndLong,
-        help: "Set a recurrence rule: hourly, daily, weekly, monthly, yearly")
+        help: "Set a recurrence rule: daily, weekly, monthly, yearly")
     var `repeat`: Recurrence?
 
     func run() {

Sources/RemindersLibrary/Reminders.swift

@@ -65,15 +65,13 @@ public enum DisplayOptions: String, Decodable {
 }
 
 public enum Recurrence: String, ExpressibleByArgument, CaseIterable {
-    case hourly
     case daily
     case weekly
     case monthly
     case yearly
 
     var frequency: EKRecurrenceFrequency {
         switch self {
-            case .hourly: return .daily
             case .daily: return .daily
             case .weekly: return .weekly
             case .monthly: return .monthly
@@ -82,27 +80,12 @@ public enum Recurrence: String, ExpressibleByArgument, CaseIterable {
     }
 
     func toRecurrenceRule() -> EKRecurrenceRule {
-        if self == .hourly {
-            // EventKit's public API only exposes daily/weekly/monthly/yearly.
-            // For hourly, we use daily frequency with interval=1 as the closest
-            // supported approximation — the reminder will repeat every day.
-            // Users who need true hourly recurrence should set it in Reminders.app.
-            return EKRecurrenceRule(
-                recurrenceWith: .daily,
-                interval: 1,
-                end: nil
-            )
-        }
         return EKRecurrenceRule(
             recurrenceWith: self.frequency,
             interval: 1,
             end: nil
         )
     }
-
-    var displayString: String {
-        return self.rawValue
-    }
 }
 
 public enum Priority: String, ExpressibleByArgument {
@@ -409,7 +392,7 @@ public final class Reminders {
             default:
                 var message = "Added '\(reminder.title!)' to '\(calendar.title)'"
                 if let recurrence = recurrence {
-                    message += " (repeats: \(recurrence.displayString))"
+                    message += " (repeats: \(recurrence.rawValue))"
                 }
                 print(message)
             }