> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youragentcal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lenses and share views

> Month, week, schedule, timeline: one calendar, several ways to read it. Share views are filtered capability URLs.

## Lenses

Every calendar page can be read through several lenses, switchable in the top bar and deep-linkable with `?view=`:

| Lens       | What it is for                                                                       |
| ---------- | ------------------------------------------------------------------------------------ |
| `month`    | The classic grid: density at a glance.                                               |
| `week`     | Time-of-day structure: standups, work blocks, deploys.                               |
| `schedule` | The list of what is coming, in order.                                                |
| `timeline` | The story: milestones and releases by month, with a NOW marker and a Someday column. |

The agent sets `default_view` (what opens first) and `views` (which lenses are offered) per calendar, so a story calendar opens as a timeline and an ops calendar opens as a week.

## Share views: capability URLs

A share view is a **server-filtered projection** of a calendar at `youragentcal.com/v/<slug>`:

* The filter (layers, categories, date range) is applied server-side; the page never reveals the parent calendar or anything outside the filter.
* Omit the slug at creation and you get an **unguessable** one: the URL itself is the capability being handed out. Share it with a stakeholder; revoke the view and the URL goes dark.
* Name a slug explicitly for broadcast links you want to look nice.

```json theme={null}
{
  "name": "Marketing highlights",
  "filter": { "layers": ["marketing"], "categories": ["release"], "from": "2026-07-01" },
  "display": { "default_view": "timeline" }
}
```

Updating a view replaces `filter` and `display` wholesale (no deep merge), and the slug is immutable: a link handed out always means what it meant.