Skip to content

Releases: Okle42/cool42

Release list

cool42 1.1.0 — catches throttling that macOS reports as Nominal

cool42 1.1.0 — catches throttling that macOS reports as Nominal Latest
Latest

Choose a tag to compare

View all tags
@Okle42 Okle42 released this 09 Oct 18:44
v1.1.0
4f46531

Stock macOS let the P-cores of a Mac mini M4 drop 7.4% under full CPU+GPU load while thermal pressure read Nominal the whole time. 1.1.0 catches that.

Highlights

  • Clock throttling check (silent throttling) — throttling now means any of: thermal pressure above Nominal, GPU CLTM > 5%, or a hot P-cluster (≥ 100 °C) running below 95% of its all-core full-load clock (M4 = 3936 MHz, measured). On 2026-10-06/07 it logged real "pressure still Nominal" throttling down to 2,949 MHz. Chips other than the M4 need clockFullLoadMHz set.
  • Default criticalTemp 100 → 108 °C — the cool42 curve runs at full speed at ~104 °C under the same load, so 100 °C would have blocked AI work on a machine that isn't throttling. Config files that hard-code 100 need a manual edit.
  • New panel — monitoring only, borderless Liquid Glass like the Dock, one-click fan mode (Curve / Fixed / Auto); everything else moved to a Settings window (⌘,).
  • Renamed to cool42 everywhere (CLI, daemon, paths, MCP server cool42). Old cool91 installs are not migrated — uninstall the old one first.
  • perf comparison scripts (extras/perf_vs_temp.py) and the 2026-09-25 same-machine data in docs/perf-2026-09-25/.

Full list: CHANGELOG.md

Install (Apple Silicon, macOS 14+)

V=1.1.0; T="$(mktemp -d)" && cd "$T" \
  && curl -fsSLO "https://github.com/Okle42/cool42/releases/download/v$V/cool42-$V-arm64.zip" \
  && curl -fsSLO "https://github.com/Okle42/cool42/releases/download/v$V/cool42-$V-arm64.zip.sha256" \
  && shasum -a 256 -c "cool42-$V-arm64.zip.sha256" \
  && ditto -xk "cool42-$V-arm64.zip" "$T" && "$T/cool42-$V/install.sh"

Known limits

  • Ad-hoc signed, not notarized. install.sh clears the quarantine attribute, so you are vouching for the package yourself — read install.sh first. A root LaunchDaemon controls the fan.
  • Tested on one Mac mini M4 (macOS 26 / 27). The stock-vs-curve comparison is a single run (n=1).
  • The curve trades noise and power for speed: ~17% more CPU power on that run.
  • Reports from other chips are very welcome: open a chip report issue.
Assets 4
Loading

cool42 1.0.0

cool42 1.0.0

Choose a tag to compare

View all tags
@Okle42 Okle42 released this 18 Sep 03:44
v1.0.0
002cd54

First public release / 第一個正式公開版.

Temperature, fan and clock monitor for Apple Silicon, plus a gatekeeper that keeps AI agents from cooking your Mac. Full details in CHANGELOG.md and the README (English / 繁體中文).

Apple Silicon 溫度 / 風扇 / 頻率監控面板 + 讓 AI agent 不燒機的守門員。

Install / 安裝：git clone https://github.com/Okle42/cool42.git && cd cool42 && ./install.sh

Loading