hey-you

Human-readable CRUD wrapper for recurring OS time triggers.

Translates human time expressions into cron or systemd timers — whichever your system uses.

hey-you repeat "HH>1MI<5"           "aider --no-git --message 'health check'"
hey-you repeat "every monday at 9"  "aider-skills run weekly-summary"
hey-you list
hey-you explain "0 9 * * 1"
hey-you resolve "HH>1MI<5"
hey-you remove 3

Why

The OS owns the timer. hey-you is a one-shot translator and crontab/systemd manager.

Installation

pipx install os-hey-you

Requires Python ≥ 3.12.

Placeholder Notation

Built on three POSIX/GNU standards:

• Field names: strftime(3)
• Relative offsets: GNU date --date
• Target format: crontab(5)

Supported tokens (YAGNI — no YYYY, no SS: standard cron has neither):

Each token may carry an offset: >N adds, <N subtracts.

HH>1MI<5    →  hour+1, minute-5
MM>1DD      →  next month, current day
HH MI       →  current hour and minute, no offset

Backend Detection

hey-you auto-detects your OS scheduler:

systemd PID 1?  →  writes ~/.config/systemd/user/hey-you-NNNN.timer
else            →  writes user crontab entry

Override: HEY_YOU_BACKEND=systemd or HEY_YOU_BACKEND=cron.

On Fedora Silverblue, cron requires: rpm-ostree install cronie + restart. systemd is the default and preferred backend.

CRUD

Update = remove + repeat. YAGNI.

Example Use Cases

Daily health check via aider

hey-you repeat "HH MI" "aider --no-git --message 'check project health'"

Weekly summary every Monday at 09:00

hey-you repeat "0 9 * * 1" "aider-skills run weekly-summary"

Understand an existing cron entry

hey-you explain "0 9 * * 1"
# every Monday at 09:00

Preview a placeholder without writing

hey-you resolve "HH>1MI<5"
# 25 17 * * *

License

MIT — © roebi