3.5 KiB
3.5 KiB
nag, a bash script for setting one-off or repeating alarms
Help
nag list
Usage:
nag list
Description:
List all alarms. This is the default when no subcommand is given.
nag at
Usage:
nag [at] <time> <message...>
Description:
Create a one-shot alarm. The "at" is optional. If the first argument
doesn't match any other subcommand of nag, it'll fallback to "at".
Examples:
nag 3pm take a break
nag at 3pm take a break
nag "tomorrow 9am" dentist appointment
nag every
Usage:
nag every <rules> <time> <message...>
Description:
Create a repeating alarm. Rules are comma-separated and case-insensitive.
Rules (and aliases):
hour (h, hourly) monday (mon, mondays)
day (d, daily) tuesday (tue, tuesdays)
week (weekly) wednesday (wed, wednesdays)
month (monthly) thursday (thurs, thursdays)
year (yearly) friday (fri, fridays)
weekday (weekdays) saturday (sat, saturdays)
weekend (weekends) sunday (sun, sundays)
Examples:
nag every weekday 9am standup meeting
nag every tue,thu 3pm team sync
nag every year "December 25" Christmas
nag stop
Usage:
nag stop <id>
Description:
Stop an alarm by ID.
nag skip
Usage:
nag skip <id>
Description:
Skip the next occurrence of a repeating alarm (reschedule without firing).
For one-shot alarms, this deletes them.
nag check
Usage:
nag check
Description:
Check for due alarms and fire them. Run automatically by a systemd
timer (every 15s) or cron (every 60s). Repeating alarms are
rescheduled. One-shot alarms are removed. Stale alarms older than
15 minutes are silently dropped or rescheduled without firing.
nag mute
Usage:
nag mute
Description:
Mute alarm sounds. Notifications still fire, but no sound is played.
nag unmute
Usage:
nag unmute
Description:
Unmute alarm sounds.
nag help
Usage:
nag help [<subcommand>]
Description:
Display help information for nag or a specified subcommand.
nag version
Usage:
nag ( version | --version )
Description:
Display the current program version.
License
MIT - see LICENSE.