remind

A friendly terminal reminder scheduler using at and notify-send.

Schedule a reminder in plain English and get both a desktop popup and an email at the exact same time — even after you close the terminal.

What it does

• Schedules reminders by minutes from now, specific time, or day+time
• Fires a desktop notification via notify-send
• Sends an email via msmtp at the same moment
• Repeats every N minutes indefinitely with the repeat flag (self-rescheduling at jobs)
• Lists pending reminders with interactive cancel (type a number to cancel, stay in the menu to cancel more)
• Clears all pending reminders with one command
• Jobs survive terminal close and persist across reboots (via atd spool)

Requirements

• at / atd — job scheduler daemon
• notify-send — desktop notifications
• msmtp — lightweight SMTP client (configured with a gmail account)

Install

cp remind ~/.local/bin/remind
chmod +x ~/.local/bin/remind

Make sure ~/.local/bin is on your PATH.

Usage

remind "Take a break"      25             # in 25 minutes
remind "Finish the parser" 14:30          # at 2:30 PM today
remind "Submit report"     "Monday 09:00" # next Monday at 9 AM
remind "Drink water"       30 repeat      # every 30 minutes, forever

remind list     # show pending reminders; type a number to cancel, 0 to exit
remind clear    # cancel all pending at-jobs (stops repeating reminders too)

Key commands

Command	Effect
remind "msg" <N>	Remind in N minutes
remind "msg" HH:MM	Remind at specific time today
remind "msg" "Day HH:MM"	Remind on a specific day
remind "msg" <N> repeat	Remind every N minutes, forever
remind list	Show all pending reminders, cancel by number
remind clear	Cancel all pending at-jobs (stops repeating reminders)

How repeat works

repeat uses a self-rescheduling technique: each fired at job pipes itself back to at before it exits, queuing the next occurrence. Since at is one-shot by design, this chains jobs together indefinitely. Use remind clear or atrm <job-id> to stop the chain.