Skip to content

fix: clarify notification alarms and native Urgent #80

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
steipete merged 1 commit into from
Sep 7, 2026
Merged

fix: clarify notification alarms and native Urgent #80

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions Sources/remindctl/Commands/AddCommand.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ enum AddCommand {
CommandSpec(
name: "add",
abstract: "Add a reminder",
discussion: "Provide a title as an argument or via --title.",
discussion: """
Provide a title as an argument or via --title.
--alarm schedules a notification; it does not enable the native Urgent toggle in Reminders.app.
EventKit does not expose Urgent. To enable it, use Reminders.app.
""",
signature: CommandSignatures.withRuntimeFlags(
CommandSignature(
arguments: [
Expand All @@ -18,7 +22,9 @@ enum AddCommand {
.make(label: "list", names: [.short("l"), .long("list")], help: "List name", parsing: .singleValue),
.make(label: "listID", names: [.long("list-id")], help: "List ID or ID prefix", parsing: .singleValue),
.make(label: "due", names: [.short("d"), .long("due")], help: "Due date", parsing: .singleValue),
.make(label: "alarm", names: [.short("a"), .long("alarm")], help: "Alarm date", parsing: .singleValue),
.make(
label: "alarm", names: [.short("a"), .long("alarm")], help: "Notification date", parsing: .singleValue
),
.make(
label: "location",
names: [.long("location")],
Expand Down
10 changes: 8 additions & 2 deletions Sources/remindctl/Commands/EditCommand.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ enum EditCommand {
CommandSpec(
name: "edit",
abstract: "Edit a reminder",
discussion: "Use an index or ID prefix from the show output.",
discussion: """
Use an index or ID prefix from the show output.
--alarm schedules a notification; it does not enable the native Urgent toggle in Reminders.app.
EventKit does not expose Urgent. To enable it, use Reminders.app.
""",
signature: CommandSignatures.withRuntimeFlags(
CommandSignature(
arguments: [
Expand All @@ -20,7 +24,9 @@ enum EditCommand {
label: "listID", names: [.long("list-id")], help: "Move to list by ID or ID prefix", parsing: .singleValue
),
.make(label: "due", names: [.short("d"), .long("due")], help: "Set due date", parsing: .singleValue),
.make(label: "alarm", names: [.short("a"), .long("alarm")], help: "Set alarm date", parsing: .singleValue),
.make(
label: "alarm", names: [.short("a"), .long("alarm")], help: "Set notification date", parsing: .singleValue
),
.make(label: "notes", names: [.short("n"), .long("notes")], help: "Set notes", parsing: .singleValue),
.make(
label: "url",
Expand Down
3 changes: 3 additions & 0 deletions docs/commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,8 @@ Useful `add` options:
- `--leaving` changes a location trigger to leaving.
- `--radius <meters>` adjusts the geofence radius.

`--alarm` schedules a notification; it does not enable the native **Urgent** toggle in Reminders.app. EventKit does not expose Urgent, so `remindctl` cannot set it. Use `--alarm` for a notification, or enable Urgent directly in Reminders.app.

## Edit reminders

```bash
Expand All @@ -74,6 +76,7 @@ remindctl edit 4A83 --no-repeat
If `add`, `edit`, or `complete` reports `Reminder is missing a calendar`, EventKit saved the reminder but returned it without its list. Check Reminders.app before retrying; this error does not roll back the saved change.

Changing or clearing only the due date leaves every alarm unchanged. Explicit alarm edits preserve relative and location-based alarms while replacing or clearing absolute alarms.
As with `add`, `edit --alarm` schedules a notification without enabling native Urgent. Set Urgent in Reminders.app.

## Lists

Expand Down