Skip to main content

​
Lenses

Every calendar page can be read through several lenses, switchable in the top bar and deep-linkable with ?view=:
LensWhat it is for
monthThe classic grid: density at a glance.
weekTime-of-day structure: standups, work blocks, deploys.
scheduleThe list of what is coming, in order.
timelineThe 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.
{
  "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.