Apple日历命令行

技能简介

accli 是面向 macOS Apple Calendar 的命令行工具，通过 JavaScript for Automation 技术实现日历数据的读取与写入。无需打开图形界面即可完成日历列表查询、事件增删改查及空闲时间检测等操作。

能做什么

• 列出所有可用日历及其持久化ID
• 按时间范围查询事件，支持关键词过滤
• 创建定时或全天事件，可指定地点与描述
• 更新现有事件的任意字段
• 删除指定事件
• 跨日历检查空闲/忙碌时段
• 设置默认日历简化后续操作

使用说明

安装指令

npm install -g @joargp/accli

系统要求：仅限 macOS（依赖 JavaScript for Automation）

基础 workflow

1. 首次使用先执行 accli calendars --json 获取日历名称与ID
2. 查询事件时建议添加 --json 便于程序解析
3. 创建事件前可用 accli freebusy 确认时间段可用性
4. 删除操作前务必与用户二次确认

常用命令示例

# 查询本周工作日历事件
accli events Work --json

# 创建会议
accli create Work --summary "团队站会" --start 2025-01-15T09:00 --end 2025-01-15T09:30 --json

# 检查多日历空闲状态
accli freebusy --calendar Work --calendar Personal --from 2025-01-15 --to 2025-01-16 --json

输入与输出

见下方输入与输出表格。

风险提示

• 删除操作不可逆，执行前必须人工确认
• 依赖 macOS 专有自动化接口，无法在其他操作系统运行
• 日历名称可能重复，生产环境建议使用 --calendar-id 替代名称
• 时区处理遵循系统设置，跨时区场景需额外校验

来源信息

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