Omahub
← All plugins
E

Site Health

by Elijah

Endpoint and network health checks

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
a6d3853
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
a6d3853
Reviewed
1 month ago

The plugin is a straightforward endpoint health monitor with well-bounded shell scripts that validate inputs, limit output sizes, and block SSRF-style private-IP destinations. No obfuscation, persistence, credential theft, or destructive commands were found. The deterministic scan found no issues, and the manual review agrees.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/AiHKhaled/omarchy-site-health --enable
Widgets #bar #quickshell #system

Site Health

Install and remove it with Omarchy's plugin commands:

omarchy plugin add https://github.com/AiHKhaled/omarchy-site-health.git --enable
omarchy plugin remove elijah.site-health

Site Health monitors endpoint reachability, latency, HTTP responses, and TLS certificate expiry from an Omarchy bar widget. The bar stays icon-only; click it for per-site details, then click a row to open that endpoint.

After installation, click the widget and choose Manage. Add each URL and optional display name, then choose Save sites. The plugin writes the sites to Omarchy's existing shell configuration for you; no JSON editing or restart is required.

Configure it inline in ~/.config/omarchy/shell.json:

{
  "id": "elijah.site-health",
  "intervalSeconds": 60,
  "thresholds": {
    "latencyMs": 2000,
    "httpFailure": 400,
    "certExpiryDays": 14,
    "consecutiveFailures": 2
  },
  "sites": [
    { "url": "https://example.com", "name": "Example" },
    { "url": "https://status.example.com" }
  ]
}

Only url is required. name defaults to the URL hostname. Healthy sites use the theme's green role, latency/HTTP/certificate warnings use yellow/accent, and failures use red/urgent. The checker uses only curl, jq, openssl, awk, and date already available on a standard Omarchy install.

The plugin is licensed under MIT. It stores only latency history under ~/.local/state/site-health; site configuration remains in Omarchy's shell.json.

Thresholds are optional and use these defaults:

  • intervalSeconds: check interval, from 5 seconds to 24 hours (60)
  • latencyMs: total response time at which a successful check is degraded (2000)
  • httpFailure: 4xx status at or above which a response is degraded (400); 5xx is down
  • certExpiryDays: certificate warning window (14); an expired certificate is down
  • consecutiveFailures: failed checks before a site is down (2); earlier failures are degraded