remind
Gate: gated
on remind, target the constant user
· write
Schedule a notification for later. At that time you get message as written — there is no model run at delivery, the text is fixed when the reminder is created. Checks the remind kind, which the root policy allows, so it runs without a prompt.
Input
| Field | Type | Required | Notes |
|---|---|---|---|
when | string | yes | Either "in <duration>" ("in 30m", "in 2h") or an absolute RFC3339 timestamp. For a wall-clock time, get the current time from time_now and pass the RFC3339 result. |
message | string | yes | What to remind you about. Leak-scanned at delivery. |
title | string | no | Optional short title. |
Output
The reminder's id and the moment it will fire:
{ "id": "rem-…", "fireAt": "2026-07-18T09:00:00+02:00" }Keep the id if you want to cancel it later with remind_cancel.
From JavaScript
nocturn.remind("in 2h", "stretch");nocturn.call("remind", { when: "in 2h", message: "stretch" });Notes
A malformed when is rejected as bad arguments rather than guessed at — a reminder that fires at the wrong time is worse than one that never got scheduled.