The oi calendar commands give you a read-only view of your schedule, combining two data sources:
- External ICS events — imported from calendar sources you configure
- Scheduled work items — tasks and sub-tasks that have a
scheduleGranularity of date or datetime
Use the calendar view to understand what is already on your schedule before claiming or scheduling new work.
Calendar sources
Before external events appear in calendar views, you need to register at least one ICS source.
Aliases
The following alias forms are accepted and resolve to the same commands:
Viewing the calendar
Day view
Returns all events and scheduled work items for a single day. If --date is omitted, today is used.
oi calendar events is an accepted alias for oi calendar day.
Week view
Returns a 7-day window starting at --start-date. If --start-date is omitted, the window starts today.
Event detail
Returns full details for a single event ID taken from day or week output. Pass --include-raw-payload to include the raw ICS/backend payload alongside the normalized fields.
Flags reference
Example workflow