viticci/remctl

解決する課題

RemCTL は macOS リマインダーのコマンドラインインターフェース (CLI) を提供し、パワーユーザーと AI エージェントがプログラムでタスクを管理できるようにします。リマインダーデータベースへの高速で詳細なアクセスを提供することで、標準 API の制限を克服します。これには、基本的なスクリプトではアクセスできないセクション、タグ、スマートリストなどの高度な機能のサポートが含まれます。

仕組み

RemCTL は、速度、権限、システムの安定性のバランスを取るためにハイブリッドアーキテクチャを使用します：

• 読み取りパス：ローカルの iCloud リマインダーデータベースから直接 SQLite 読み取りを実行し、詳細なメタデータにほぼ瞬時にアクセスします。
• 書き込みパス：Apple の公開 EventKit API を使用して、変更がデバイス間で正しく同期されるようにします。
• プライベート API パス：高度なメタデータ（サブタスク、タグ、食料品リストの分類など）について、オプションで明示的な --private フラグを使用してプライベート ReminderKit フレームワークを使用します。
• 権限ホスト：権限を簡素化するため、ほとんどのコマンドは署名付きの RemCTL Capability Host.app を経由してルーティングされます。このアプリが必要なフルディスクアクセスと自動化の権限を保持しているため、呼び出し元のターミナルやエージェントは個別にそれらを必要としません。

対象者

• macOS パワーユーザー：ターミナルやシェルスクリプト経由でリマインダーを管理したいユーザー。
• AI エージェント：ユーザーのタスクリストと対話する信頼性の高い方法を必要とするエージェント（例：Claude Code や Codex を使用）を構築する開発者。

ハイライト

• 深い統合：セクション、サブタスク、タグ、画像添付ファイル、カスタムスマートリストをサポートします。
• エージェントフレンドリー：JSON 出力と構造化されたコマンドマップを提供し、LLM との統合を容易にします。
• スマートリスト管理：優先度、日付、またはフラグに基づいてカスタムスマートリストを作成および編集する機能。
• 食料品リストサポート：食料品固有のメタデータのネイティブ処理と自動分類。
• 柔軟なスケジューリング：自然言語風の日付解析（例："tomorrow 3pm"、"+3d"、"eod"）をサポートします。