Discord Reminder Agent Skill

Mac-mini Discord reminder

Use the remote-host instead of Aside routine slots for scheduled reminders.

• Resolve relative dates in Asia/Seoul and choose a concrete KST time. If the user gives no time, use 10:00 KST and state it.
• Store the executable script at ~/Projects/<프로젝트>/<slug>.sh on remote-host with mode 700.
• Load Discord credentials only at runtime from ~/Projects/<프로젝트>/discord_bot/.env. Never print or copy token values.
• Send the DM through Discord API v10 to BAMBAM_USER_ID. Include a non-empty User-Agent header to avoid Cloudflare blocking.
• Store the LaunchAgent at ~/Library/LaunchAgents/com.bambam.reminder-<slug>.plist.
• One-time reminder: use StartCalendarInterval with Year, Month, Day, Hour, and Minute.
• Recurring reminder: use only the requested recurring calendar fields.
• Never use StartInterval on this remote-host. Verified 2026-08-16: every

StartInterval LaunchAgent in the gui/501 domain sits at

pended nondemand spawn = interval and does not fire, including one that

had previously run 2,429 times. StartCalendarInterval jobs fire normally.

For an every-N-minutes job, list the minutes explicitly, e.g.

[{Minute: 0}, {Minute: 5}, ... {Minute: 55}] for a 5-minute cadence.

• Write stdout and stderr to ~/Projects/<프로젝트>/<slug>.log.
• Validate and load without firing the reminder immediately:
• plutil -lint <plist>
• launchctl bootout gui/$(id -u)/<label> if an old copy exists
• launchctl bootstrap gui/$(id -u) <plist>
• launchctl print gui/$(id -u)/<label>
• plutil -p <plist> to verify the exact schedule
• Confirm it actually fires. launchctl print showing the job loaded is not

proof — watch runs increment across two scheduled ticks, or check the job's

own log for two consecutive scheduled entries. A job can load cleanly and

never spawn.

• Do not test-send a real DM unless the user asks. Report the resolved date, time, timezone, delivery channel, and loaded label.

Use concise reminder text that says what happened, what the user should do next, and any account or product distinction needed to avoid a wrong action.

바로 쓰는 스크립트

scripts/make-reminder.sh — 일회성 리마인더를 launchd에 등록합니다.

export DISCORD_BOT_TOKEN=... DISCORD_USER_ID=...
./scripts/make-reminder.sh cancel-check "2026-09-02 10:00" "구독 해지 확인하기"

지정한 시각에 DM이 한 번 가고 잡이 스스로 내려갑니다.

StartInterval이 아니라 StartCalendarInterval을 쓰는 이유는 아래 함정 항목을 보세요.