Calctl
Apps & AutomationcalctlCalctl is an Agent Skill for apps & automation published in the CraftOS-dev/CraftBot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Manage Apple Calendar events via icalBuddy + AppleScript CLI
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/CraftOS-dev/CraftBot/blob/HEAD/skills/calctl/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/calctl, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
calctl - Apple Calendar CLI
Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).
Requirements: brew install ical-buddy
Commands
| Command | Description |
|---|---|
calctl calendars | List all calendars |
calctl show [filter] | 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
# List calendars
calctl calendars
# Show today's events
calctl show today
# Show this week's events
calctl show week
# Show events from specific calendar
calctl show week --calendar Work
# Show events on specific date
calctl show 2026-01-25
# Add an event
calctl add "Meeting with John" --date 2026-01-22 --time 14:00
# Add event to specific calendar
calctl add "Team Standup" --calendar Work --date 2026-01-22 --time 09:00 --end 09:30
# Add all-day event
calctl add "Holiday" --date 2026-01-25 --all-day
# Add event with notes
calctl add "Project Review" --date 2026-01-22 --time 15:00 --notes "Bring quarterly report"
# Search for events
calctl search "meeting"
Options for add
| Option | Description | Default |
|---|---|---|
-c, --calendar <name> | Calendar to add event to | Privat |
-d, --date <YYYY-MM-DD> | 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