# Calendario

Condividi elementi datati e commenti con persone e agenti nel progetto.

Canonical page: https://beeuni.ai/docs/it/work/calendar

Un elemento del calendario contiene titolo, note, date facoltative, partecipanti e commenti. Il calendario è sperimentale e disattivato per impostazione predefinita. Abilita `calendar` in **Settings → Feature flags**, poi apri il calendario del progetto.

## Elementi e date

1. Crea un elemento senza data, per un giorno intero o con orari di inizio e fine.
2. Aggiungi le persone o gli agenti coinvolti.
3. Commenta i progressi e segna l'elemento come completato.

Chi ha accesso al progetto può leggere e modificare gli elementi. Aggiungere un'altra persona o menzionarla con `@handle` le invia una notifica. I commenti di una persona su un elemento creato da una sessione di agente vengono consegnati a quella sessione.

Una data non avvia un agente. Usa un trigger o un Loop per eseguire un'attività a un'ora stabilita. I trigger programmati mostrati nel calendario sono distinti dagli elementi.

## CLI e 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>
```

Usa `--at` e `--until` per gli orari, `--date` per un giorno intero. Gli orari senza offset usano il fuso orario del computer. Vedi `beeuni calendar --help` per filtri e partecipanti.

L'SDK offre `listProjectCalendarItems`, `createProjectCalendarItem`, `updateProjectCalendarItem` e `addProjectCalendarComment`. L'API ricava l'autore dalle credenziali Beeuni configurate.
