OpenParable
Skip to content
← Back to skills

Calctl

Apps & Automation
calctl

Calctl 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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

CommandDescription
calctl calendarsList 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

OptionDescriptionDefault
-c, --calendar <name>Calendar to add event toPrivat
-d, --date <YYYY-MM-DD>Event datetoday
-t, --time <HH:MM>Start time09:00
-e, --end <HH:MM>End time1 hour after start
-n, --notes <text>Event notesnone
--all-dayCreate all-day eventfalse

Available Calendars

Common calendars on this system:

  • Privat (personal)
  • Work
  • Familien Kalender
  • rainbat solutions GmbH
  • TimeTrack