Assume calkit --version works. Kernel users can install it from Settings › General › Utilities.

​
Init

In an empty folder (or a folder you want to own as the calendar): 
mkdir my-calendar && cd my-calendar
calkit init --name "My Calendar" --owner "Me" --timezone America/Chicago --json
This writes: 
.calkit/            marker (commands walk up until they find this)
calendar.yaml       name, owner, timezone, defaults
scopes.yaml         scope tracks
events/<scope>/     one YAML file per event
It also runs git init. Fresh repos start with personal, business, and birthdays tracks. --timezone is an IANA name (America/Chicago, UTC).

​
First checks

calkit doctor --json
calkit schema --json
calkit scope list --json
schema is the exact shape for events, scopes, calendar metadata, and reminders. Agents should load it before inventing fields. validate checks files and referential integrity without the extra health extras doctor adds.

​
Finding the repo

You can run calkit from a subdirectory. Discovery walks up until .calkit/ exists.

​
Next

Events.