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.
oi calendar source list
oi calendar source create --display-name <name> --source-url <ics-url> [--inactive]
oi calendar source sync <source-id>
oi calendar source delete <source-id>
Aliases
The following alias forms are accepted and resolve to the same commands:
| Alias | Resolves to |
|---|
oi sources list | oi calendar source list |
oi calendar-source list | oi calendar source list |
Viewing the calendar
Day view
oi calendar day [--date <YYYY-MM-DD>] [--domain-id <id>] [--include-resolved]
--date is omitted, today is used.
oi calendar events is an accepted alias for oi calendar day.
Week view
oi calendar week [--start-date <YYYY-MM-DD>] [--domain-id <id>] [--include-resolved]
--start-date. If --start-date is omitted, the window starts today.
Event detail
oi calendar event <event-id> [--include-raw-payload]
day or week output. Pass --include-raw-payload to include the raw ICS/backend payload alongside the normalized fields.
Flags reference
| Flag | Applies to | Description |
|---|
--date | day | Date to view (YYYY-MM-DD) |
--start-date | week | Start of the 7-day window (YYYY-MM-DD) |
--domain-id | day, week | Limit work items to a specific domain |
--include-resolved | day, week | Include resolved work items in the output |
--include-raw-payload | event | Include raw ICS/backend payload in the response |
Example workflow
# Check today's schedule
oi calendar day
# Check a specific date
oi calendar day --date 2026-03-01
# Check the coming week starting from a date
oi calendar week --start-date 2026-03-01
# Inspect a specific event from the day/week output
oi calendar event jd713d9jr6s2w2m60acf6r0a3h81s296
# List all configured calendar sources
oi calendar source list
# Sync a source manually
oi calendar source sync <source-id>