日历命令行管理

技能简介

calctl 是一个基于 icalBuddy 和 AppleScript 的命令行工具，用于在 macOS 上读取和管理 Apple Calendar 事件。icalBuddy 负责快速读取日历数据，AppleScript 负责写入操作。

业务背景

无需打开日历应用，通过命令行快速查看和管理日程安排。适合习惯终端操作的技术人员或需要批量处理日程的场景，提升时间管理的效率，减少在图形界面间切换的干扰。

落地案例：开发团队每日站会前，成员在终端输入指令查看当日会议安排，确认冲突事项；项目经理通过命令行批量创建迭代周期内的里程碑事件，设置提醒时间和备注信息，避免逐一手动录入。

能做什么

• 列出所有可用日历
• 查看今日、明日、本周或指定日期的事件
• 按日历筛选事件
• 创建新事件（支持设置时间、备注、全天事件）
• 搜索未来30天内的事件标题

使用说明

安装依赖：

brew install ical-buddy

基本用法：

# 列出所有日历
calctl calendars

# 查看今日事件
calctl show today

# 查看本周事件
calctl show week

# 查看指定日历的本周事件
calctl show week --calendar Work

# 查看指定日期事件
calctl show 2026-01-25

# 创建事件
calctl add "Meeting with John" --date 2026-01-22 --time 14:00

# 创建全天事件
calctl add "Holiday" --date 2026-01-25 --all-day

# 搜索事件
calctl search "meeting"

add 命令选项：

• -c, --calendar <name>：目标日历（默认 Privat）
• -d, --date <YYYY-MM-DD>：事件日期（默认今天）
• -t, --time <HH:MM>：开始时间（默认 09:00）
• -e, --end <HH:MM>：结束时间（默认开始后1小时）
• -n, --notes <text>：事件备注
• --all-day：创建全天事件

输入与输出

见下方输入与输出表格。

风险提示

• 需要预先安装 ical-buddy，未安装时功能不可用
• 写入操作通过 AppleScript 执行，需确保系统权限允许脚本控制日历
• 默认日历为德语名称 “Privat”，使用前请确认本地日历名称
• 搜索范围限制为未来30天，无法查找更早的历史事件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rainbat/calctl/SKILL.md
来源类型：GitHub 仓库