calendar-cli

name	calendar-cli
description	Command-line calendar management using 'khal'.
metadata	{"navig":{"emoji":"📅","requires":{"bins":["khal"],"config":["khal.conf"]}}}

Calendar CLI Skill

Manage your schedule, appointments, and agenda from the terminal using khal.

Core Commands

View Schedule

# Show agenda for today and tomorrow
khal list

# Show agenda for next 7 days
khal list today 7d

# Show specific date
khal list 2024-03-25

Add Event

Natural language support for quick entry.

# Quick add
khal new "Lunch with Team tomorrow 12:00 to 13:00"

# Specific calendar
khal new -a work "Meeting with Client 14:00"

# Interactive add (if supported by agent/terminal)
khal new

Edit & Delete

# Search for an event to get details
khal search "Lunch"

# Delete an event (interactive confirmation usually required, use --force if available in config or script wrapper)
# Note: khal does not have a direct 'delete by ID' aimed at automation easily without interactive selection,
# so 'search' + manual intervention is often safest for agents unless using a specific wrapper.

Integration with LifeOS

Combine with task-warrior for a complete daily plan:

1. Run khal list today to see hard landscape (meetings).
2. Run task next to fill gaps with soft landscape (todos).

Configuration

Requires configured ~/.config/khal/config pointing to local vdirsyncer directories or local ics files.