rtime-reminder

name	rtime-reminder
description	Use when registering, listing, cancelling, testing, or diagnosing rtime Feishu reminders and scheduled reminder delivery. Trigger for Chinese or English reminder requests such as "提醒我", "定时提醒", "闹钟", "remind me", or "schedule a reminder"; use the rtime JSONL reminder path and never Claude Code Cron for phone push reminders.

Rtime Reminder

Use the system reminder path for Feishu phone push reminders:

brain/_system/reminders.jsonl

Do not use Claude Code CronCreate, CronList, or CronDelete for Feishu phone reminders. Those tasks belong to the current Claude session and do not feed reminder.timer / reminder-sender.js.

Register

Parse the user's requested time as Beijing time unless they explicitly specify another timezone. Convert it to an ISO datetime with timezone, then use:

Choose the mode explicitly:

• notify: send a fixed message without waking the assistant model.
• wake: at due time, run an independent assistant task and send its result.

Default decision rule:

• Use notify only when the user wants a literal, self-contained push message and no reasoning is useful at trigger time.
• Use wake when the reminder depends on the current conversation, study or exam state, travel timing, project status, completion state, or the user wants the assistant to judge, summarize, check, ask, or give advice at trigger time.

For wake, write a self-contained prompt for the future assistant run. Include the original request, due time, known facts, user concern, and the expected outbound message style. Do not rely on the current chat still being in context when the reminder fires. If you omit --prompt, the register helper generates a generic fallback prompt from message and due, but that is lower quality than passing the relevant context yourself.

rtime-reminder-register add --mode notify --due "2026-06-11T09:30:00+08:00" --message "提醒内容"
rtime-reminder-register add --mode wake --due "2026-06-11T09:30:00+08:00" --message "唤醒标题" --prompt "到点执行的助手任务"

Repeat values:

none hourly daily weekly

For repeat reminders:

rtime-reminder-register add --mode notify --due "2026-06-12T08:00:00+08:00" --repeat daily --message "提醒内容"

List Or Cancel

rtime-reminder-register list --status pending
rtime-reminder-register list --status failed
rtime-reminder-register cancel --id <reminder-id>

The tool returns metadata only: id, due, repeat, status, message length, and whether a target is configured. Do not expose Feishu open_id values or private message bodies unless the user explicitly asks to inspect the raw JSONL.

If registration fails because no target is configured, use the runtime's current RTIME_REMINDER_DEFAULT_TARGET; do not copy targets from old reminder records after a Feishu app migration.

Smoke

Use scripts/reminder-smoke.sh to validate the local tool with a temporary JSONL file. It must not write to the real brain reminder store.