healthd

Lightweight host health daemon for one machine: scheduled checks, machine-readable status, and alerts on fail/recover transitions.

Install

Homebrew

brew tap uinaf/tap
brew install healthd

Direct install

curl -fsSL https://raw.githubusercontent.com/uinaf/healthd/main/scripts/install.sh | bash
# optional pinned version:
# curl -fsSL https://raw.githubusercontent.com/uinaf/healthd/main/scripts/install.sh | bash -s -- v0.1.0
healthd --version

Quickstart

healthd init
healthd validate --config ~/.config/healthd/config.toml
healthd check --config ~/.config/healthd/config.toml
healthd status --config ~/.config/healthd/config.toml
healthd status --config ~/.config/healthd/config.toml --watch
healthd notify test --config ~/.config/healthd/config.toml
healthd run --config ~/.config/healthd/config.toml

healthd run is meant to be supervised (process-compose, systemd, launchd).

Example notify config

[notify]
cooldown = "5m"

[[notify.backend]]
name = "ntfy-phone"
type = "ntfy"
topic = "replace-with-strong-random-topic"

[[notify.backend]]
name = "local-log"
type = "command"
command = "logger -t healthd-alert"
timeout = "5s"

More complete host profiles: examples/current-host.toml.

Docs

• Architecture — components, lifecycle, design choices
• Contributing — setup, verify, pull requests
• Releases — Conventional Commits publish path
• Security — private vulnerability reporting

License

MIT