RemAt

Simple reminder scheduling tool that links atd, chrono and libnotify.

Requirements

• Linux with at installed, the atd daemon running, and permission to use at
• libnotify (notify-send) and a notification daemon
• Node.js >= 24

Installation

# one of
pnpm install --global remat
yarn global add remat
npm install -g remat

Usage

rem <when> <message...>

<when> accepts:

• natural language via chrono: 14:52, "tomorrow at 9:00", "next friday at 4 pm"
• a bare number, meaning minutes from now: rem 20 ... fires in 20 minutes
• :MM, meaning the next occurrence of that minute: rem :45 ... fires at the next hh:45 (this hour if it hasn't passed yet, otherwise the next one)

A multi-word <when> must either be quoted or separated from the message with --:

rem 14:52 go to the gym
rem "tomorrow at 9:00" go to the gym
rem 4th of july at noon -- go to the gym
rem "next friday at 4 pm" go to the gym
rem 20 go to the gym
rem :25 go to the gym

Use the regular atd commands to list (atq) and cancel (atrm) the scheduled jobs.

Exit codes: 0 scheduled, 2 usage error (bad arguments or unparseable time), 1 runtime failure (at missing or refusing the job).