calctl - Apple Calendar CLI
Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).
Requirements: INLINECODE0
Commands
| Command | Description |
|---|
| INLINECODE1 | List all calendars |
| INLINECODE2 |
Show events (today, tomorrow, week, YYYY-MM-DD) |
|
calctl add <title> | Create a new event |
|
calctl search <query> | Search events by title (next 30 days) |
Examples
CODEBLOCK0
Options for add
| Option | Description | Default |
|---|
| INLINECODE6 | Calendar to add event to | Privat |
| INLINECODE7 |
Event date | today |
|
-t, --time <HH:MM> | Start time | 09:00 |
|
-e, --end <HH:MM> | End time | 1 hour after start |
|
-n, --notes <text> | Event notes | none |
|
--all-day | Create all-day event | false |
Available Calendars
Common calendars on this system:
- - Privat (personal)
- Work
- Familien Kalender
- rainbat solutions GmbH
- TimeTrack
calctl - Apple Calendar 命令行工具
通过命令行管理 Apple 日历,使用 icalBuddy(快速读取)和 AppleScript(写入)。
系统要求: brew install ical-buddy
命令
| 命令 | 描述 |
|---|
| calctl calendars | 列出所有日历 |
| calctl show [筛选条件] |
显示事件(今天、明天、本周、YYYY-MM-DD) |
| calctl add <标题> | 创建新事件 |
| calctl search <查询> | 按标题搜索事件(未来30天) |
示例
bash
列出日历
calctl calendars
显示今天的事件
calctl show today
显示本周的事件
calctl show week
显示特定日历的事件
calctl show week --calendar Work
显示特定日期的事件
calctl show 2026-01-25
添加事件
calctl add 与John的会议 --date 2026-01-22 --time 14:00
将事件添加到特定日历
calctl add 团队站会 --calendar Work --date 2026-01-22 --time 09:00 --end 09:30
添加全天事件
calctl add 假期 --date 2026-01-25 --all-day
添加带备注的事件
calctl add 项目评审 --date 2026-01-22 --time 15:00 --notes 带上季度报告
搜索事件
calctl search 会议
add 命令的选项
| 选项 | 描述 | 默认值 |
|---|
| -c, --calendar <名称> | 添加事件的日历 | 私人 |
| -d, --date <YYYY-MM-DD> |
事件日期 | 今天 |
| -t, --time
| 开始时间 | 09:00 |
| -e, --end | 结束时间 | 开始后1小时 |
| -n, --notes <文本> | 事件备注 | 无 |
| --all-day | 创建全天事件 | 否 |
可用日历
此系统上的常用日历:
- - 私人(个人)
- 工作
- 家庭日历
- rainbat solutions GmbH
- TimeTrack