> ## 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.

# Calendar

> View calendar events and manage ICS sources with the `oi` CLI.

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.

```bash theme={null}
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

```bash theme={null}
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.

<Note>
  `oi calendar events` is an accepted alias for `oi calendar day`.
</Note>

### Week view

```bash theme={null}
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

```bash theme={null}
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

| 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

```bash theme={null}
# 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>
```