throt

Tiny throttle wrapper: queue a command once within a delay window. Repeats during the window are ignored; stale locks get replaced.

• Use cases: noisy webhooks, bursty fs events (inotify/FSEvents), message-broker bursts, timer jobs where you need one reaction per batch.
• Config: ~/.throt or env (THROT_LOCK_DIR, THROT_LOG_FILE). Defaults: $HOME/tmp/throt-locks, $HOME/tmp/throt.log.
• Usage: throt --delay 10 <cmd ...>. Logs enqueue, skips, stale-lock cleanup, start, and finish.

Install

brew tap hmepas/homebrew-throt
brew install throt

Notes

• Lock is keyed by the command hash; lock freshness window is delay * 5.
• nohup handles detach; log is plain ISO timestamps with messages.