Erinnerungen

Eine Erinnerung fordert eine Sitzung später erneut zur Eingabe auf – einmalig oder wiederholt, bis du sie entfernst.

Eine Erinnerung sendet zu einem von dir festgelegten Zeitpunkt eine Aufforderung an eine bestehende session. Sie wird einmal ausgelöst oder wiederholt, bis jemand sie entfernt. Ein Agent nutzt eine Erinnerung, um die eigene Arbeit nachzuverfolgen: „In 24 Stunden prüfen, ob der Anbieter geantwortet hat“, „Jede Stunde prüfen, ob der Deploy erfolgreich war“.

Eine Erinnerung ist ein trigger, der auf eine Sitzung beschränkt ist. Die Unterschiede:

Verwende einen Trigger für Projektaufgaben, die alle sehen sollten, etwa eine tägliche Zusammenfassung. Verwende eine Erinnerung für eine Nachverfolgung, die zu einer einzelnen Aufgabe gehört.

Erinnerungen aktivieren

Erinnerungen sind ein projektweites feature flag, reminders, das standardmäßig deaktiviert ist. Aktiviere es unter Settings → Feature flags oder mit:

beeuni projects features enable reminders

Solange das Flag deaktiviert ist, antworten alle Routen für Erinnerungen mit 403 und code: "feature_disabled". Die Seite „Reminders“ erklärt, wie du es aktivierst, und bestehende Erinnerungen werden nicht ausgelöst. Wenn du das Flag wieder aktivierst, wird ein während der Deaktivierung verpasster Termin einmal ausgelöst; anschließend wird der Zeitplan fortgesetzt.

Erinnerung festlegen

Innerhalb einer Sitzung zielt die CLI auf die aktuelle Sitzung. Außerhalb einer Sitzung übergibst du --session <id>.

# Fire once, 24 hours from now.
beeuni remind "Check whether the vendor replied to the contract email." --in 24h

# First fire in 24 hours, then every hour until removed.
beeuni remind "Did the vendor reply? If yes, summarize it and remove this reminder." --in 24h --every 1h

# Fire at an exact instant.
beeuni remind "Post the launch checklist to #launch." --at 2026-10-01T09:00:00Z

# Repeat on a cron expression in a time zone.
beeuni reminders add "Post the standup summary." --cron "0 0 9 * * 1-5" --timezone Europe/Berlin

Der Befehl gibt die Erinnerungs-ID aus, zum Beispiel reminder.3f9a1c2e7b04, sowie den nächsten Auslösungszeitpunkt.

Zeitplanregeln

• --in <duration> oder --at <ISO-8601> legt die erste Auslösung fest. Ohne weitere Angaben wird die Erinnerung einmal ausgelöst.
• --every <duration> legt Wiederholungen fest. Der Mindestzeitraum beträgt 5m. Jeder Zeitraum beginnt, wenn die vorherige Auslösung beansprucht wird.
• --cron "<expr>" wiederholt sich nach einem 6-Felder-Cron-Ausdruck (Sekunden zuerst). --timezone legt die Zeitzone fest; Standard ist UTC. Eine Cron-Erinnerung darf höchstens alle 5 Minuten ausgelöst werden. Sie akzeptiert weder --in noch --at.
• Zeitangaben sind 30m, 24h, 2d oder ganze Sekunden.
• --in, --at und --every akzeptieren höchstens 366 Tage.
• Eine Sitzung kann höchstens 20 aktive Erinnerungen enthalten. Für ein Projekt gilt ein Maximum von 200. Bei Überschreitung eines der beiden Limits wird 409 zurückgegeben.

Was beim Auslösen geschieht

Bei jeder Auslösung wird der Erinnerungstext als Aufforderung mit folgendem Header in die Sitzung eingereiht:

[REMINDER reminder.3f9a1c2e7b04 — recurring scheduled check-in on this session, not a new user message. When it is no longer needed, run `beeuni reminders rm reminder.3f9a1c2e7b04`.]

Did the vendor reply? If yes, summarize it and remove this reminder.

• Eine geparkte Sitzung wird fortgesetzt. Der Agent hat Zugriff auf den vollständigen Gesprächsverlauf und den Workspace der Sitzung.
• Eine Auslösung startet niemals eine neue Sitzung. Wenn die Sitzung gelöscht wird oder fehlschlägt, pausiert die Auslösung die Erinnerung und hält den Grund unter last_error fest.
• Bei einer Auslösung bleiben die persönlichen Verbindungen der Sitzung erhalten, etwa das Gmail-Konto eines Mitglieds. Wenn du eine Erinnerung für eine Sitzung festlegst, für die du nicht handelst, werden diese entfernt – genauso wie beim Senden einer Aufforderung an diese Sitzung.
• Die projektweite Trigger-Pause (beeuni triggers pause) stoppt auch Erinnerungen.

Jede Auslösung ist ein Modellturn. Entferne eine wiederkehrende Erinnerung, sobald ihre Bedingung erfüllt ist.

Erinnerungen verwalten

Eine Erinnerung ist active (geplant), paused (aus) oder done (eine einmalige Erinnerung, die ausgelöst wurde).

API und SDK

Die Routen gelten jeweils für eine Sitzung:

Ein ungültiger Zeitplan gibt 400 mit dem Grund zurück. Eine gelöschte Sitzung gibt 409 zurück. Ein Agent-Zugangsdatenobjekt, das eine andere Sitzung angibt, gibt 403 zurück.

const reminders = beeuni.session(projectId, sessionId).reminders;
const reminder = await reminders.create({ prompt: 'Did the vendor reply?', in: '24h', every: '1h' });
await reminders.update(reminder.id, { enabled: false });
await reminders.remove(reminder.id);