Recurring events store one definition. They expand on read.

​
Agenda (default: next 7 days)

calkit agenda --json
calkit agenda --from today --to +2w --json
calkit agenda --scope business --from today --to +7d --json

​
Next

calkit next --json
calkit next --count 5 --scope personal --json

​
List definitions

calkit list --json
calkit list --scope business --status confirmed --json
calkit list --query standup --json
calkit list --from today --to +1mo --expand --json
Without --expand, you get stored events (one row per file). With --expand, you get occurrences in the window.

​
Date tokens

Anywhere a date is accepted:
  • YYYY-MM-DD or YYYY-MM-DDTHH:MM
  • today
  • +Nd days, +Nw weeks, +Nmo months
Example: calkit agenda --from today --to +2w --json.