Apple Reminders

• ターミナルを離れたり GUI アプリに切り替えたりせずに、リマインダーをすばやく追加・完了・確認したい場合。
• Apple Reminders をプログラムから読み書きする必要があるシェルスクリプトや AI エージェントのワークフローを構築している場合。
• 他のツールやパイプラインに渡すために、Apple Reminders から構造化された出力（JSON または TSV）が必要な場合。
• Reminders アプリを開かずに、SSH 経由で Mac 上のリマインダーを管理したい場合。

• macOSを使用していない場合 — このツールはDarwin専用であり、LinuxやWindowsでは動作しません。
• ネイティブのApple Remindersアプリではなく、サードパーティのタスクマネージャー（Todoist、Things、OmniFocusなど）を使用している場合。
• Apple以外のプラットフォームでiCloud同期の可視性が必要な場合。remindctlはローカルのmacOS Remindersデータベース上でのみ動作します。

today（今日）、tomorrow（明日）、week（今週）、overdue（期限切れ）、upcoming（近日予定）、completed（完了済み）、または特定の YYYY-MM-DD 形式の日付でリマインダーをすばやくフィルタリングできます。クエリロジックを一切記述することなく、毎日のブリーフィングを作成したり、期限切れの項目を確認したりするのに便利です。

add でリマインダーを作成し、edit でタイトルや期限日を更新し、complete で1件または複数件を完了としてマークし、delete --force で完全に削除します。すべての操作は、リマインダーをそのIDで対象指定します。

すべての Apple Reminders リストの表示、特定のリストからのリマインダーの表示、リストの作成・名前変更・削除を、すべてコマンドラインから行えます。

構造化データパイプライン向けには --json、タブ区切り値には --plain、件数のみ表示には --quiet を使って結果を出力できます。これにより、remindctl はシェルスクリプト、自動化ツール、AIエージェントへの統合が容易になります。

期日の設定やフィルタリングの際に、自然言語の省略表現（today、tomorrow）、YYYY-MM-DD、YYYY-MM-DD HH:mm、および完全な ISO 8601 タイムスタンプに対応しています。

セッション開始時に remindctl today --json を実行すると、本日期限のすべてのリマインダーが構造化された形式で表示され、AIエージェントがカレンダーのイベントやメッセージとともにそれらを要約できるようになります。

remindctl add --title "Review PR" --list Work --due tomorrow を使用すると、Apple Reminders アプリに切り替えることなくタスクを記録でき、ターミナルでの作業に集中し続けることができます。

remindctl overdue を実行して期限切れのアイテムをすべて確認し、次に remindctl complete 1 2 3 を使用して複数のリマインダーを1つのコマンドで完了済みにマークします。

remindctl week --plain を他のシェルツールや自動化スクリプトにパイプすることで、GUIを一切使わずに今後のリマインダーを処理、フィルタリング、またはレポート化することができます。