Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.orca.0-9.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
AliasResolves to
oi sources listoi calendar source list
oi calendar-source listoi calendar source list

​
Viewing the calendar

​
Day view

oi calendar day [--date <YYYY-MM-DD>] [--domain-id <id>] [--include-resolved]
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

oi calendar week [--start-date <YYYY-MM-DD>] [--domain-id <id>] [--include-resolved]
Returns a 7-day window starting at --start-date. If --start-date is omitted, the window starts today.

​
Event detail

oi calendar event <event-id> [--include-raw-payload]
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

FlagApplies toDescription
--datedayDate to view (YYYY-MM-DD)
--start-dateweekStart of the 7-day window (YYYY-MM-DD)
--domain-idday, weekLimit work items to a specific domain
--include-resolvedday, weekInclude resolved work items in the output
--include-raw-payloadeventInclude 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>