mcpField
S
schedule-manager

schedule-manager

github.com/niraclerProductivity11179 installsUpdated 15w ago
Repository

About schedule-manager

Schedule Manager is a macOS skill for managing Calendar events and Reminders using osascript and reminders-cli, organized around GTD practices. It can combine schedules, tasks, and optional project YAML data for weekly planning.

Key features

  1. 01View, create, and delete Calendar events
  2. 02Create and complete Reminders tasks
  3. 03Separate fixed-time events from to-dos
  4. 04Combine calendars and reminders for planning
  5. 05Use project schedule YAML for weekly plans

Use cases

  1. 01Capturing a task in Reminders
  2. 02Scheduling a meeting in Calendar
  3. 03Planning a day with time blocks
  4. 04Reviewing the week and checking project capacity

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/niracler/skill --skill schedule-manager

After installing, type/schedule-managerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
gtd-methodology.md
osascript-calendar.md
osascript-reminders.md
reminders-cli-guide.md
scripts/
check_dependencies.sh
check_permissions.sh

Details

From the project README

Schedule Manager

通过 osascript (Calendar) 和 reminders-cli (Reminders) 管理日程，遵循 GTD 方法论。

Prerequisites

ToolTypeRequiredInstall
macOSsystemYesThis skill requires macOS
osascriptcliYesBuilt-in on macOS
reminders-clicliYesbrew install keith/formulae/reminders-cli
Schedule YAMLdataNo~/code/*/planning/schedules/*.yaml — for cross-project weekly planning

Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.

权限配置

首次运行需要授权，进入系统设置 → 隐私与安全性：

  1. 日历 - 勾选 Terminal / iTerm / 你使用的终端应用
  2. 提醒事项 - 同上

⚠️ 修改权限后需重启终端应用

核心原则（GTD 风格）

工具用途示例
Calendar固定时间承诺会议、约会、截止日期
Reminders待办事项（无固定时间）购物清单、任务、想法

决策流程：

有具体时间？ → Calendar 事件
无具体时间？ → Reminders 待办
需要提醒？ → 两者都可设置提醒

模式选择

用户意图模式操作
「安排会议」「创建事件」Calendar创建带时间的事件
「添加待办」「创建提醒」「记一下」Reminders创建任务
「查看日程」「今天有什么」查询查询 Calendar + Reminders
「规划下周」「周回顾」规划综合工作流

Calendar 操作

通过 osascript 管理 Calendar 事件（查看、创建、删除）。

详见 osascript-calendar.md 获取完整命令模板。

Reminders 操作

推荐使用 reminders-cli（osascript 访问 Reminders 非常慢）。

常用命令速查：

reminders show-lists              # 查看列表
reminders show-all --due-date today  # 今日待办
reminders add "列表" "任务"         # 创建
reminders complete "列表" 0        # 完成

详见 reminders-cli-guide.md 获取完整命令参考。 osascript 备选见 osascript-reminders.md。

常见工作流

场景 1: 快速收集（GTD Capture）

用户说「记一下」「待会做」「别忘了」→ 创建 Reminder 到收件箱

reminders add "提醒" "<任务名>"
场景 2: 安排会议

用户说「安排明天下午 2 点的会议」→ 创建 Calendar 事件（使用 osascript）

场景 3: 每日规划
  1. 查看今日 Calendar 事件（osascript）
  2. 查看 Reminders 待办（reminders show-all）
  3. 为重要任务安排 Time Block（Calendar 事件）
场景 4: 周回顾（GTD Weekly Review）
  1. 查看本周完成的提醒
  2. 查看下周 Calendar 事件（osascript）
  3. 整理 Reminders 列表（reminders show-all）

详见 gtd-methodology.md。

场景 5: 跨项目周规划（需要 Schedule YAML）

当 ~/code/*/planning/schedules/*.yaml 存在时，「规划下周」工作流增加项目排期上下文：

  1. 扫描 ~/code/*/planning/schedules/*.yaml，解析每个文件的 project、timeline、capacity
  2. 查看下周 Calendar 已有事件（osascript）
  3. 查看 Reminders 待办（reminders show-all）
  4. 从 schedule YAML 中提取下周相关 module（按 weeks 字段匹配）
  5. 按 capacity.days_per_week 估算各项目时间分配
  6. 合并展示：Calendar 事件 + Reminders 待办 + 各项目模块任务
  7. 标注产能冲突（总分配 > 可用工作日）
  8. 建议 Calendar time block（展示建议，用户确认后创建）

无 Schedule YAML 时：跳过步骤 4-7，退化为标准的场景 4 周回顾流程。

常见错误

错误原因解决
AppleEvent timed out权限未授予在系统设置中授权
Can't get list列表不存在先用 reminders show-lists 查看可用列表
Invalid date日期格式错误使用 current date 作为基准
reminders: command not found未安装brew install keith/formulae/reminders-cli
osascript Reminders 卡顿已知性能问题改用 reminders-cli

Comments

Markdown supported