All apps/khal

khal

khal

A command-line calendar application

Runs as khal, ikhal|macOS, Linux, Windows|lostpackets.de

Command form

ai-draft · 2 tasks · 10 fields

List events in a date range or add a new event to a calendar. Editing, importing, search and the interactive UI are left out.

Opens the form; the finished command lands at your prompt, unrun
otty gui khal

khal list

List events
List eventsExample values, fixed in this page — nothing here reaches a terminal
Basic
Start, end or delta
todaystring
Only these calendars
string
TasksEach one presets the form for one job
Upcoming events
rangeinclude
ParametersOnly these flags are editable in the form
Start, end or delta
For example: today 30d, or 2019-12-01 31d.
string · positional 0 · repeatable
Only these calendars
string · repeatable
-a
Exclude these calendars
string · repeatable
-d
Output format
For example: {title} {description}.
string
--format

khal new

Add an event
Add an eventExample values, fixed in this page — nothing here reaches a terminal
Basic
Start, end, timezone and summary*
string
Calendar
string
Location
string
TasksEach one presets the form for one job
Add an event
eventcalendarlocation
ParametersOnly these flags are editable in the form
Start, end, timezone and summary
For example: tomorrow 16:30 Coffee Break. Text after :: becomes the description.
string · positional 0 · repeatable
Calendar
The default calendar is used when empty.
string
-a
Location
string
--location-l
Categories
Comma separated.
string
--categories-g
Repeat
enum
--repeat-rdailyweeklymonthlyyearly
Repeat until
string
--until-u
SourcesEvery flag above is checked against these
doc
khal list [-a CALENDAR ... | -d CALENDAR ...] [--format FORMAT] [--json FIELD ...] [--day-format DAYFORMAT] [--once] [--notstarted] [START [END | DELTA] ] khal list -a soccer today 30d .. option:: --format FORMAT .. option:: -a CALENDAR .. option:: -d CALENDAR
manualusage.rst master 2026-10

lostpackets.de

doc
khal list [-a CALENDAR ... | -d CALENDAR ...] [--format FORMAT] [--json FIELD ...] [--day-format DAYFORMAT] [--once] [--notstarted] [START [END | DELTA] ] khal list -a soccer today 30d .. option:: --format FORMAT .. option:: -a CALENDAR .. option:: -d CALENDAR
manualmaster 2026-10

github.com

doc
khal new [-a CALENDAR] [OPTIONS] [START [END | DELTA] [TIMEZONE] SUMMARY [:: DESCRIPTION]] * **-l, --location=LOCATION** specify where this event will be held. * **-g, --categories=CATEGORIES** specify which categories this event belongs to. * **-r, --repeat=RRULE** specify if and how this event should be recurring. Valid values for *RRULE* are `daily`, `w…
manualmaster 2026-10

github.com

Before it fills your prompt, Otty checks the installed khal against its version. A form that does not match your version is not offered.