# Calendário

Compartilhe itens com data e comentários com pessoas e agentes do projeto.

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

Um item do calendário tem título, notas, datas opcionais, participantes e comentários. O calendário é experimental e vem desativado. Ative `calendar` em **Settings → Feature flags** e abra o calendário do projeto.

## Itens e datas

1. Crie um item sem data, de dia inteiro ou com horários de início e fim.
2. Adicione as pessoas ou os agentes participantes.
3. Comente o andamento e marque o item como concluído.

Quem tem acesso ao projeto pode ler e editar os itens. Adicionar outra pessoa ou mencioná-la com `@handle` envia uma notificação. Comentários de uma pessoa em um item criado por uma sessão de agente são entregues àquela sessão.

Uma data não inicia um agente. Use um gatilho ou um Loop para executar trabalho em um horário definido. Os gatilhos agendados exibidos no calendário são diferentes dos itens.

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

Use `--at` e `--until` para horários, e `--date` para dias inteiros. Horários sem deslocamento usam o fuso do computador. Consulte filtros e participantes em `beeuni calendar --help`.

O SDK oferece `listProjectCalendarItems`, `createProjectCalendarItem`, `updateProjectCalendarItem` e `addProjectCalendarComment`. A API identifica o autor pela credencial Beeuni configurada.
