Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub · Productivity
ical
Manages macOS Calendar events and calendars from the terminal using the ical CLI. Full CRUD for both events and calendars. Supports natural language dates, r...
skill openclawclawhub Free
Manages macOS Calendar events and calendars from the terminal using the ical CLI. Full CRUD for both events and calendars. Supports natural language dates, r...
⬇ 0 downloads ★ 0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, references/commands.md, references/dates.md
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 0.6.0
Provenance
- Publisher
- BRO3886
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
ical — CLI for macOS Calendar
A Go CLI that wraps macOS Calendar. Sub-millisecond reads via cgo + EventKit. Single binary, no dependencies at runtime.
Installation
go install github.com/BRO3886/ical/cmd/ical@latest Or build from source: git clone <repo-url> && cd ical make build # produces bin/ical
Quick Start
# List all calendars (shows sources, colors, types) ical calendars # Create a new calendar ical calendars create "Projects" --source iCloud --color "#FF6961" # Show today's agenda ical today # List events this week ical list --from today --to "end of week" # Add an event with natural language dates ical add "Team standup" --start "tomorrow at 9am" --end "tomorrow at 9:30am" --calendar Work --alert 15m # Show event details (row number from last listing) ical show 2 # Delete an event (--force skips confirmation prompt, required in scripts/agents) ical delete 2 --force # Search for events ical search "meeting" --from "30 days ago" --to "next month" # Export events to ICS ical export --format ics --from today --to "in 30 days" --output-file events.ics
Event CRUD
CommandAliasesDescriptionical addcreate, newCreate an eventical showget, infoShow full event detailsical updateeditUpdate event propertiesical deleterm, removeDelete an event
Event Views
CommandAliasesDescriptionical listls, eventsList events in a date rangeical today—Show today's eventsical upcomingnext, soonShow events in the next N days
Search & Export
CommandAliasesDescriptionical searchfindSearch events by title, location, notesical export—Export events to JSON, CSV, or ICSical import—Import events from JSON or CSV file
Calendar Management
CommandAliasesDescriptionical calendarsicalsList all calendarsical calendars createadd, newCreate a new calendarical calendars updateedit, renameUpdate a calendar (rename, recolor)ical calendars deleterm, removeDelete a calendar and all its events
Skills & Other
CommandAliasesDescriptionical skills install—Install ical agent skill for Claude Code / Codexical skills uninstall—Remove ical agent skillical skills status—Show skill installation statusical version—Print version and build infoical completion—Generate shell completions (bash/zsh/fish) For full flag details on every command, see references/commands.md.
Row Numbers
Event listings display row numbers (#1, #2, #3...) alongside events. These are cached to ~/.ical-last-list so you can reference them in subsequent commands: ical list --from today --to "next week" # Shows #1, #2, #3... ical show 2 # Show details for row #2 ical update 3 --title "New title" # Update row #3 ical delete 1 --force # Delete row #1 (skip confirmation) ical delete 1 # Delete row #1 (prompts for confirmation) Row numbers reset each time you run a list/today/upcoming command. With no arguments, show, update, and delete launch an interactive picker instead.
Event ID flag (for scripts and agents)
When you have a full event ID (from -o json output), use --id for exact lookup with no prefix matching: # Get event ID from JSON output EVENT_ID=$(ical today -o json | jq -r '.[0].id') # Use --id for reliable exact lookup ical show --id "$EVENT_ID" ical update --id "$EVENT_ID" --title "New title" ical delete --id "$EVENT_ID" --force Important for scripting: ical delete prompts for interactive confirmation by default. Always pass --force (or -f) when running non-interactively. There is no --confirm flag. ical update does not require confirmation and has no --force flag — just run it directly with the flags you want to change. --id and a positional argument are mutually exclusive — passing both returns an error.
Natural Language Dates
Date flags (--from, --to, --start, --end, --due) accept natural language: ical list --from today --to "next friday" ical add "Lunch" --start "tomorrow at noon" --end "tomorrow at 1pm" ical search "standup" --from "2 weeks ago" ical upcoming --days 14 Supported patterns: today, tomorrow, next monday, in 3 hours, eod, eow, this week, 5pm, mar 15, 2 days ago, and more. See references/dates.md for the full list.
Interactive Mode
The add and update commands support -i for guided form-based input: ical add -i # Multi-page form: title, calendar, dates, location, recurrence ical update 2 -i # Pre-filled form with current event values The show, update, and delete commands accept 0 arguments to launch an interactive event picker: ical show # Pick from upcoming events ical delete # Pick an event to delete
Output Formats
All read commands support -o / --output: table (default) — formatted table with borders and color json — machine-readable JSON (ISO 8601 dates) plain — simple text, one item per line The NO_COLOR environment variable and --no-color flag are respected.
Recurrence
Events can repeat with flexible rules: # Daily standup ical add "Standup" --start "tomorrow at 9am" --repeat daily # Every 2 weeks on Mon and Wed ical add "Team sync" --start "next monday at 10am" --repeat weekly --repeat-interval 2 --repeat-days mon,wed # Monthly for 6 months ical add "Review" --start "mar 1 at 2pm" --repeat monthly --repeat-count 6 # Yearly until a date ical add "Anniversary" --start "jun 15" --repeat yearly --repeat-until "2030-06-15" Use --repeat none on update to remove recurrence. Use --span future to update/delete this and all future occurrences.
Alerts
Add reminders before an event with the --alert flag (repeatable): ical add "Meeting" --start "tomorrow at 2pm" --alert 15m # 15 minutes before ical add "Flight" --start "mar 15 at 8am" --alert 1h --alert 1d # 1 hour + 1 day before Supported units: m (minutes), h (hours), d (days).
Daily review
ical today # See today's agenda ical upcoming --days 1 # Same as today ical list --from today --to "end of week" # Rest of the week
Weekly planning
ical upcoming --days 7 # Full week view ical add "Planning" --start "monday at 9am" -i # Add events interactively
Scripting with JSON output
# Count today's events ical today -o json | jq 'length' # Get titles of upcoming events ical upcoming -o json | jq -r '.[].title' # Find events on a specific calendar ical list --from today --to "in 30 days" --calendar Work -o json | jq '.[].title' # List calendar names (field is "title", not "name") ical calendars -o json | jq -r '.[].title' # Get calendar IDs and names ical calendars -o json | jq -r '.[] | "\(.id) \(.title)"' Calendar JSON fields: id, title, type, color, source, readOnly Event JSON fields: id, title, start_date, end_date, calendar, calendar_id, location, notes, url, all_day, recurrence, alerts
Backup and restore
# Export all events from the past year ical export --from "12 months ago" --to "in 12 months" --format json --output-file backup.json # Export as ICS for other calendar apps ical export --from today --to "in 6 months" --format ics --output-file events.ics # Import from backup ical import backup.json --calendar "Restored"
Public Go API
For programmatic access to macOS Calendar, use go-eventkit directly: import "github.com/BRO3886/go-eventkit/calendar" client, _ := calendar.New() events, _ := client.Events(from, to, calendar.WithCalendarName("Work")) event, _ := client.CreateEvent(calendar.CreateEventInput{ Title: "Team Meeting", StartDate: start, EndDate: end, CalendarName: "Work", }) See go-eventkit docs for the full API surface.
Limitations
macOS only — requires EventKit framework via cgo No attendee management — attendees and organizer are read-only (Apple limitation) Subscribed/birthday calendars are read-only — cannot create events on these Event IDs are calendar-scoped — the UUID prefix before : is the calendar ID, not event-specific. Use row numbers or the interactive picker instead of raw IDs
Category context
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
3 Docs
- SKILL.md
- references/commands.md
- references/dates.md