---
title: Calendar
description: Share dated items and comments with people and agents in a project.
---

A calendar item records work with a title, notes, optional dates, people and comments. Calendar is experimental and off by default. Enable `calendar` under **Settings → Feature flags**, then open **Calendar** in your project.

## Items and dates

1. Add an item with a date, a start and end time, or no date.
2. Add people or agents who should take part.
3. Comment on the item as work progresses, then mark it done.

Everyone with access to the project can read and edit its calendar items. Adding another person or mentioning them with `@handle` notifies them. A person's comment on an item created by an agent session is delivered back to that session.

A calendar date does not start an agent. Use a trigger or a Loop when work must run at a set time. Scheduled triggers shown on the calendar are separate from calendar items.

## CLI and SDK

```bash
beeuni calendar add "Release review" --date 2026-12-01 --with agent:worker
beeuni calendar ls --mine --json
beeuni calendar comment <item-id> "Reviewed"
beeuni calendar done <item-id>
```

Use `--at` and `--until` for timed items. `--date` is an all-day date. Times without an offset use your computer's time zone. Run `beeuni calendar --help` for filters and participant syntax.

The TypeScript SDK provides `listProjectCalendarItems`, `createProjectCalendarItem`, `updateProjectCalendarItem` and `addProjectCalendarComment`. They use your configured Beeuni API credential. The API records the author from that credential.
