Command reference
oko-cli calendar add
Creates one event on a writable account: EventKit, Google, Microsoft, or CalDAV.
Invocation
oko-cli calendar add --account ID --title T --starts ISO [--ends ISO] [--all-day] [--location L] [--notes N] [--uid UID]Inputs and options
- --account names the connected account and --title with --starts (ISO-8601) are required; --ends defaults to one hour later (one day for --all-day).
- --uid pins the CalDAV resource name and the Google event id, which makes creation idempotent and duplicates detectable.
Output and state effect
- Creates the event on the provider — an .ics resource PUT with If-None-Match for CalDAV, an API insert for Google and Microsoft, a saved EKEvent for EventKit — then mirrors the provider's answer into the local events file immediately; the next sync reconciles.
Refusals and safe exits
- An ICS account refuses: account '…' is an ICS subscription, which is read-only; events cannot be added, edited, or removed.
- A duplicate uid on CalDAV refuses: an event with uid '…' already exists on account '…'.
- An unknown account, an unparseable --starts/--ends, and the ungrated EventKit consent each refuse with their exact sentence.