Khal

Read calendar events from the terminal with khal.

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

List Events

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.

Search Events

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.

Parsing Notes

• 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