apple-calctl
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
03 SKILL.md 正文
calctl Skill
Native macOS Calendar CLI built with EventKit. No AppleScript, no osascript.
When to invoke
Trigger when user says or asks for:
- "calendar CLI"
- "apple calendar from terminal"
- "calctl"
- "event CLI for macOS"
- "list calendar events from command line"
- "create calendar event from terminal"
- "add recurring event"
- "schedule recurring calendar"
- "weekly meeting in calendar"
- "every monday calendar event"
How to use
The calctl CLI is already built at https://github.com/christianteohx/calctl. Clone and build it, or install via Homebrew.
Install (Homebrew, recommended):
brew install christianteohx/tap/calctl
Direct binary:
curl -fsSL https://github.com/christianteohx/calctl/releases/latest/download/calctl -o ~/bin/calctl
chmod +x ~/bin/calctl
Build from source (macOS 13+, Swift 6.0+):
git clone https://github.com/christianteohx/calctl
cd calctl
swift build
.build/release/calctl <command>
First run: macOS will prompt for Calendar permission. Grant it in System Settings > Privacy & Security > Calendars > Terminal.
Commands
calctl status check calendar access status
calctl authorize trigger permission prompt
calctl list list all calendars (with id, title, source)
calctl today [--attendees] show today's events (--attendees shows invitees)
calctl tomorrow [--attendees] show tomorrow's events (--attendees shows invitees)
calctl week [--attendees] show this week's events (--attendees shows invitees)
calctl date YYYY-MM-DD [--attendees] show events for a specific date
calctl add --title ... --start ... --end ... [--recurrence RULE] create an event
calctl edit --id <id> ... edit an event
calctl delete --id <id> delete an event
--calendar <name> filter by calendar name
Recurring events
Add --recurrence with iCalendar RRULE syntax:
calctl add --title "Weekly Standup" --start "2026-04-14 09:00" --end "2026-04-14 09:30" --recurrence "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO"
calctl add --title "Daily Reminder" --start "2026-04-15 08:00" --end "2026-04-15 08:05" --recurrence "FREQ=DAILY"
calctl add --title "Monthly Report" --start "2026-05-01 10:00" --end "2026-05-01 11:00" --recurrence "FREQ=MONTHLY;BYMONTHDAY=1"
Supported RRULE keys: FREQ (DAILY/WEEKLY/MONTHLY/YEARLY), INTERVAL, BYDAY, BYMONTHDAY, COUNT, UNTIL.
Attendees
Use --attendees on today, tomorrow, week, or date commands to show attendee information:
calctl today --attendees
calctl week --attendees
Shows each attendee's name/email and participation status (accepted, pending, declined, tentative, etc.). Events with no attendees show no attendee data. Available in both plain text and JSON output.
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.