An Apple Reminders CLI for power users and AI agents. RemCTL supports all the latest Reminders features such as sections, subtasks, tags, rich links, groceries lists, templates, smart lists, and image attachments. (Not affiliated with Apple.)

RemCTL – コマンドラインとAIツールからApple Remindersを操作

概要（平易な言葉で）

RemCTLはmacOS専用のユーティリティで、Remindersアプリを開かずにApple Remindersを読み書きできます。以下を提供します：

ターミナルCLI（remctl …）— リマインダー、リスト、期限日、優先度などを一覧表示、追加、完了、検索、管理します。
MCP（Model-Context-Protocol）サーバー — Claude Desktop、Claude Code、その他のMCP互換アプリなどのAIアシスタントが、同じコマンドをプログラム的に呼び出せます。
Claude CodeおよびCodexプラグイン — これらのAIコーディング環境内にRemindersワークスペースを埋め込み、「今日」バンドとインタラクティブなペインを表示します。
AppleのプライベートReminderKit機能（セクション、タグ、サブタスク、スマートリスト、テンプレートなど）へのアクセス。--privateフラグを渡すことで有効になります。

すべての操作は、RemCTL Capability Hostという小さな署名付きバックグラウンドアプリを介して行われ、macOSの権限（Reminders、Automation、Full-Disk Access）を保持します。このホストが承認されると、CLI、スクリプト、AIツールは独自の権限を必要とせずに動作できます。

誰が使うか

パワーユーザー — タスク管理にシェル指向のワークフローを好む方。
開発者 — Remindersを操作する自動化やスクリプトを構築する方。
AIアシスタント開発者 — エージェント（Claude、Hermesなど）が標準のMCPインターフェースを介してユーザーのRemindersを読み書きできるようにしたい方。
Mac中心の生産性愛好家 — RemindersをClaude CodeやCodexワークスペースに統合したい方。

入手方法

ダウンロード — GitHub Releasesページから署名付きDMG（RemCTL-arm64.dmg）をダウンロードし、「Install RemCTL」アプリを実行します。Capability Host、プライベートPythonランタイムをインストールし、remctlバイナリをPATHに追加します。
ソースからビルド（Intel Macで必要） — AppleのCommand-Line Toolsをインストールし、リポジトリをクローンして、./install.sh --from-source --bootstrapを実行します。スクリプトはローカル署名証明書を作成し、ホストアプリが更新後も権限を保持できるようにします。

どちらの方法もmacOSパスワードを一度要求し、必要な権限を設定します。

主要コマンド（クイックチートシート）

remctl today                     # 今日期限または期限切れのタスクを表示
remctl upcoming 7                # 今後7日以内のタスク
remctl add "Review PR" -l Work -d "tomorrow 10:00" -p high
remctl done 23880                # 1つまたは複数のIDを完了としてマーク（最大50）
remctl search "invoice" --json # プログラム用のJSON出力
remctl info 23880 --json         # リマインダーの保存フィールドをすべてダンプ

すべてのコマンドは--jsonで機械可読な出力をサポートし、エイリアスrctl / remindersでも同じ動作をします。

MCPによるAI統合

remctl mcp installは、Mac上のすべての対応AIアプリにMCPサーバーを登録します。
特定のクライアントを対象に指定できます。例：remctl mcp install --client claude-desktop。
インストール後、AIアシスタントはmcp__remctl__add、mcp__remctl__searchなどのツールを呼び出し、AI UI内にインタラクティブなリマインダーウィジェットを表示することもできます。
サーバーはプライベートTailscaleネットワーク経由で公開し、リモートのClaude CodeやCodexインスタンスから利用できます（--client tailscale）。

Claude Codeプラグインのハイライト

プロンプトの上に**「今日」バンド** — カウント、期限切れアイテム、今後のタスクの短いリストを表示。
/remindersペイン — Claude Code内に完全なReminders UI（リスト、列、カレンダーレイアウト）を表示。
JSON設定による表示構成（band、compact、status、pane only）。
ライブ更新：RemCTL駆動の変更後、または数分ごとにバンドが自動更新されます。

Codexプラグインのハイライト

Codexサイドバー内の完全なRemindersワークスペース — ネイティブアプリの外観（アイコン、色、ライト/ダークモード）を反映。
ドラッグ＆ドロップ、インスペクタパネル、コマンドパレット、カスタムレイアウト（リスト、列、カレンダー）。

プライベートメタデータのサポート

RemCTLは、Appleが公開していないフィールド（セクション、タグ、サブタスクなど）を、--privateフラグを追加することで書き込めます。Appleの内部ReminderKitフレームワークを使用するため、これらの機能は将来のmacOSリリースで壊れる可能性があります。ドキュメントには、現在機能しているプライベートキーがリストされています。

エージェント対応機能

決定論的な日付形式（YYYY-MM-DDまたはYYYY-MM-DD HH:MM）。
remctl doctor --for-agent --jsonは準備状態を報告します。access.effectiveフィールドはCapability Hostが必要な権限を持っているかどうかを示します。
エージェントはremctl info <id> --jsonで書き込みを検証する必要があります。

更新とアンインストール

アップグレード — 新しいDMGをダウンロードするか、最新のソースを取得してinstall.shを再実行します。同じ署名証明書を維持することで、既存の権限が保持されます。
アンインストール — バンドルされたスクリプトまたは./uninstall.shを使用します。設定を保持する（--keep-config）か、ドライランで削除される内容を確認できます。

ドキュメントと構造

ドキュメントはdocs/フォルダにあります（インストール、コマンドガイド、MCP、プラグイン、プライベートメタデータ、アーキテクチャなど）。
コアソースファイルはREADMEのProject layoutテーブルに明確にリストされています。
ライセンス：MIT。

結論： RemCTLは、Apple Remindersとコマンドライン/スクリプトワークフロー、および現代のAIアシスタントの間の本格的で機能豊富なブリッジであり、macOS 14+専用に構築されています。

viticci/remctl