Every host. One live table.

Concurrent ICMP and TCP ping monitor for maintenance windows, on one fixed latency scale, with JSON evidence at the end.

uv tool install pinghue
View on GitHub
hostaddressstatelastminavgmaxjitterlossmodehistory
edge-router-1192.168.1.1healthy14.7911.6414.3018.431.010.00%icmp
core-sw-110.0.0.10healthy10.7510.5012.0114.270.810.00%icmp
db-primary10.0.1.20intermittent449.3120.1157.96449.3117.532.26%icmp
api-gw10.0.2.30healthy36.7634.0039.3846.852.590.00%icmp
backup-nas192.168.50.10down8.317.059.3513.151.3515.25%icmp
dns-resolver8.8.8.8healthy14.9210.6213.2617.191.290.00%icmp

A simulated run in the real pinghue TUI layout: same columns, states, latency scale and keys, with addresses shown as if you had pressed a; a narrow screen shows only some of the eleven columns. The hosts are made up. The keys work here too, and a click on a column header sorts by it.

TUI when you watch, lines when you script

One command, three ways to run it. Every mode probes your hosts concurrently and keeps the same whole-run statistics: by default ICMP gives every host its own probe slot (up to 5,000 hosts), and TCP runs up to 1024 probes at a time with --concurrency.

hostaddressstatelastminavgmaxjitterlossmodehistory
1.1.1.11.1.1.1healthy4.083.233.674.360.230.00%icmp
8.8.8.88.8.8.8healthy3.782.833.514.220.430.00%icmp
9.9.9.99.9.9.9healthy10.629.7110.2411.080.310.00%icmp

The default. Concurrent echo probes with the full TUI: history bars, states, and keyboard control. Press a to show or hide the resolved addresses.

hostaddressstatelastminavgmaxjitterlossmodehistory
1.1.1.11.1.1.1healthy6.425.886.317.020.190.00%tcp
10.0.4.1210.0.4.12down-----100.00%tcp

No privileges needed. Connect checks against any port from 1 to 65535. A refused connection prints its own amber ! in the history, so you can tell a closed port from a timeout at a glance.

$ pinghue -p 443 example.com -c 3 --no-tui
2026-10-06T02:31:04.118204+00:00 example.com ok latency=14.08ms
2026-10-06T02:31:05.119927+00:00 example.com ok latency=13.92ms
2026-10-06T02:31:06.121376+00:00 example.com ok latency=14.31ms
$ echo $?
0

For cron and CI. Line output is the default when stdout is not a terminal; on a terminal, pass --no-tui. One line per probe, exit code 3 when a --fail-on-any-down or --fail-on-all-down condition triggers, and --output for the report.

One fixed scale, every run

Latency maps to the same eight glyphs on every run. Nothing rescales, so rows stay comparable across hosts and across nights. Green until 100 ms, amber past it.

  1. up to 1 ms
  2. up to 3 ms
  3. up to 10 ms
  4. up to 30 ms
  5. up to 100 ms
  6. up to 300 ms
  7. up to 1000 ms
  8. over 1000 ms
  9. lost, down
  10. TCP refused
14 ms glyph 4 of 8, green

A host that blips once stays intermittent until you reset it with r. The report covers the whole window, not only its final minutes.

Close the window with a report

Add --output and pinghue writes a schema-versioned JSON summary when the run ends. Attach it to the change ticket and go back to bed.

Versioned contract
schema_version: 1. Breaking changes need a new schema version.
Whole-run stats
stats covers every probe in the run; samples is the recent tail, at most 1000 per host.
Private by default
Reports are written 0600, and an existing file is never replaced without --overwrite.
Exit codes
0 completed, 1 runtime error, 2 usage error, 3 a fail-on-down condition triggered.
$ pinghue -f hosts.txt --duration 180 \
    --output maintenance.json

  "schema_version": 1,
  "pinghue_version": "8.0.1",
  "run": {
    "started_at": "2026-10-06T02:28:08.412Z",
    "ended_at": "2026-10-06T02:31:08.418Z",
    "host": "local",
    "exit_reason": "deadline",
    "samples_window": 1000,
    "probe": {
      "mode": "icmp", "port": null,
      "interval_s": 1.0, …
    }
  },
  "targets": [
    {
      "target": "db-primary",
      "resolved_address": "10.0.1.20",
      "resolved_family": "ipv4",
      "status": "intermittent",
      "error": null,
      "stats": {
        "sent": 180, "received": 176,
        "loss_pct": 2.22,
        "min_ms": 20.11, "avg_ms": 64.07,
        "max_ms": 451.44, "jitter_ms": 23.59
      },
      "samples": [ … ]
    },
    …
  ]

Small on purpose

A focused local tool for maintenance windows, migrations, and quick reachability checks. Nothing more.

  • Not a Prometheus, Smokeping, Zabbix, or NMS replacement.
  • Not a long-running metrics database or alerting system.
  • Not a privileged daemon.
  • Not a packet capture or traceroute tool.
  • Not a service that accepts remote network requests.

Sixty seconds to a live table

uv tool install pinghue
pipx install pinghue
brew install inxbit/tap/pinghue
python -m pip install pinghue

macOS and Linux, Python 3.11 to 3.14. Run pinghue --check first: on Linux, ICMP may need a ping_group_range setting, and TCP mode (-p) needs none.