khal

name: khal description: Read calendar events with the `khal` CLI. Use when the user asks about meetings, schedule, upcoming events, or calendar searches.

Read calendar events from the terminal with khal.

khal list --format '{calendar}|{start}|{end}|{title}|{location}|{description}|{status}' today eod

Today's events:

khal list --format '{calendar}|{start}|{end}|{title}|{location}|{description}|{status}' today eod

Next 7 days:

khal list --format '{calendar}|{start}|{end}|{title}|{location}|{description}|{status}' today 7d

Custom range:

khal list --format '{calendar}|{start}|{end}|{title}|{location}|{description}|{status}' "start-date" "end-date"

Common date examples: now, today, tomorrow, eod, 7d, 2026-02-21.

khal does not provide a native full-text search command.

Use a wide date range and filter results in your response:

khal list --format '{calendar}|{start}|{end}|{title}|{location}|{description}|{status}' today 365d

Filter by keyword in title, description, or location after collecting the output.

Event rows use | separators in the format above
khal may print date header lines (for example Monday, 2026-02-23); treat those as section headers, not events
Return at most the number of events requested by the user