Skip to content
Beeuni
English
Esc
↑↓navigate↵open⌘Jpreview
On this page

Calendar

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

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.

Was this page helpful?