mac-reminders-agent

# Mac Reminders Agent ## Overview This skill integrates with the local macOS **Reminders** app to: - View and organize today's/this week's reminders (work/personal/sessions) - Add new reminders based on natural language requests - **Multi-language support**: English, Korean, Japanese, Chinese The skill uses the following files relative to its directory: - `cli.js` (unified entry point) - `reminders/apple-bridge.js` (backend: AppleScript + `applescript` npm module) - `locales.json` (language-specific triggers and responses) ## Language Support The skill automatically detects user language or can be explicitly set via `--locale` parameter. ### Supported Languages | Code | Language | Example Trigger | |------|----------|-----------------| | `en` | English | "What do I have to do today?" | | `ko` | 한국어 | "오늘 할 일 뭐 있어?" | | `ja` | 日本語 | "今日のタスクは？" | | `zh` | 中文 | "今天有什么任务？" | ### Language Detection 1. **Explicit**: Use `--locale` parameter 2. **Automatic**: Detect from user's message language 3. **Default**: Falls back to `en` (English) --- ## How It Works User natural language requests are handled in two cases: 1. **List reminders (list)** 2. **Add reminder (add)** For each case, call the Node.js CLI, receive JSON results, and format them using locale-specific templates. --- ## 1) List Reminders ### Trigger Examples (by language) **English:** - "What do I have to do today?" - "Show me today's reminders" - "What's on my schedule this week?" **Korean (한국어):** - "오늘 할 일 뭐 있어?" - "오늘 미리알림 정리해줘" - "이번 주 일정 뭐 있어?" **Japanese (日本語):** - "今日のタスクは？" - "今日のリマインダーを見せて" **Chinese (中文):** - "今天有什么任务？" - "显示今天的提醒" ### Command Invocation ```bash # List with default locale (en) node skills/mac-reminders-agent/cli.js list --scope today # List with specific locale node skills/mac-reminders-agent/cli.js list --scope week --locale ko ``` ### Scope Options - `today` - Today only - `week` - This week (today ~ +7 days) - `all` - All reminders ### Output Format Returns JSON array: ```json [ { "title": "Task title", "due": "2026-02-05T16:30:00" | null } ] ``` ### Response Formatting Use `locales.json` templates to format responses in user's language: **English:** ``` [Incomplete Reminders] - 2/2 (Mon) 09:00 [Work] Meeting - 2/3 (Tue) 14:00 [Personal] Visit bank [Completed] - 2/1 (Sun) [Work] Submit report ✅ ``` **Korean:** ``` [미완료 미리알림] - 2/2 (월) 09:00 [업무] 회의 - 2/3 (화) 14:00 [개인] 은행 방문 [완료됨] - 2/1 (일) [업무] 보고서 제출 ✅ ``` --- ## 2) Add Reminder ### Trigger Examples (by language) **English:** - "Add a meeting reminder for 9am tomorrow" - "Set a reminder to submit report by Friday" **Korean (한국어):** - "내일 아침 9시에 회의 미리알림 추가해줘" - "이번 주 금요일까지 보고서 제출 미리알림 넣어줘" **Japanese (日本語):** - "明日の朝9時に会議のリマインダーを追加して" **Chinese (中文):** - "添加明天早上9点的会议提醒" ### Command Invocation ```bash # Add with locale node skills/mac-reminders-agent/cli.js add --title "Meeting" --due "2026-02-05T09:00:00+09:00" --locale ko ``` ### Parameters - `--title` (required): Reminder title - `--due` (optional): ISO 8601 format (`YYYY-MM-DDTHH:mm:ss+09:00`) - `--note` (optional): Additional notes - `--locale` (optional): Response language (en, ko, ja, zh) ### Response Examples **English:** - "Added 'Meeting' reminder for 9am tomorrow." - "Added 'Submit report' reminder without a due date." **Korean:** - "'회의' 미리알림을 추가했어요 (내일 오전 9시)." - "'보고서 제출' 미리알림을 추가했어요 (마감일 없음)." --- ## Error Handling ### Locale-aware Error Messages **English:** - "There was a problem accessing the Reminders app." **Korean:** - "미리알림 앱에 접근하는 데 문제가 생겼어요." **Japanese:** - "リマインダーアプリへのアクセスに問題が発生しました。" ### Fallback Suggestions When automatic integration fails, offer alternatives in user's language. --- ## Environment Constraints - **macOS only**: Uses AppleScript to control Reminders app - **Dependency**: Requires `applescript` npm module --- ## Summary - Multi-language support via `locales.json` (en, ko, ja, zh) - Core commands: `list --scope today|week|all [--locale XX]` and `add --title ... [--due ...] [--locale XX]` - Automatically detect user language or use explicit `--locale` parameter - Format responses using locale-specific templates