Skip to content
Back to search

thermo

MarketplaceWorks with Claude CodeGitHub

Thermo: live Mac load, temperatures, memory and battery for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/simarpreetsingh-019/Thermo with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/simarpreetsingh-019/Thermo'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/simarpreetsingh-019--thermo/badge.svg)](/listings/simarpreetsingh-019--thermo)

HTML

<a href="/listings/simarpreetsingh-019--thermo"><img src="/api/listings/simarpreetsingh-019--thermo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **Downloading the zip?** macOS will warn that it can't verify Thermo. That's normal for free apps not notarized by Apple. [Here's how to open it safely](#first-launch-why-macos-warns-you) (one click in System Settings).

**Homebrew**

brew install --cask simarpreetsingh-019/thermo/thermo

Homebrew also adds the `thermo` command: `thermo status`, `thermo temps`, `thermo headroom`, `thermo help` and more (see [Use from Terminal](#use-from-terminal)).

**No Homebrew? Use the installer script.** It downloads the latest release, checks it, and installs it. Read it first, it's short:

curl -fsSL https://raw.githubusercontent.com/simarpreetsingh-019/Thermo/main/install.sh -o install.sh
bash install.sh

It can also add the `thermo` Terminal command (it asks first). Before installing anything, it checks that the zip matches the release's SHA-256 checksum, that the GitHub attestation is valid (if you have the `gh` CLI), and that the app's signature and bundle ID are intact. If any check fails, nothing is installed.

**Direct download:** grab `Thermo.zip` from [Releases](https://github.com/simarpreetsingh-019/Thermo/releases), unzip it, and drag it into Applications. See [first launch](#first-launch-why-macos-warns-you) below. For the `thermo` Terminal command, use ⚙ → Connections → **Install thermo command**.

**Build from source** (needs Xcode Command Line Tools):

git clone https://github.com/simarpreetsingh-019/Thermo && cd Thermo && ./build.sh --install

Add `--no-connect` to leave out the CLI JSON output, MCP server and local API (about 0.3 MB smaller).

Requires macOS 13+. It's a universal app (Apple Silicon and Intel), and Intel Macs read temperatures from the SMC (less tested there).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "thermo",
  3. "description": "Thermo: live Mac load, temperatures, memory and battery for AI agents.",
  4. "owner": {
  5. "name": "Simarpreet Singh",
  6. "url": "https://simarpreetsingh-019.github.io"
  7. },
  8. "plugins": [
  9. {
  10. "name": "thermo",
  11. "source": "./plugins/thermo",
  12. "description": "Live Mac CPU, GPU, memory, temperatures and battery for agents; checks headroom before heavy jobs."
  13. }
  14. ]
  15. }
README.md · README · 203 lines
  1. <p align="center"><img src="docs/icon.png" width="128" alt="Thermo icon"></p>
  2. # Thermo
  3. **Mac stats. Right on your notch.**
  4. <p align="center">
  5. <b>Created by <a href="https://simarpreetsingh-019.github.io">Simarpreet Singh</a></b> ·
  6. <a href="https://x.com/simarpreet_019">@simarpreet_019</a> ·
  7. <a href="mailto:simarpreetsingh.019@gmail.com">simarpreetsingh.019@gmail.com</a><br>
  8. If Thermo helps you, please ⭐ star the repo and share it!
  9. </p>
  10. A tiny, live system monitor that lives **in your MacBook's notch**, or floats anywhere on any Mac.
  11. It shows CPU, RAM, GPU and temperature, and when your Mac gets hot it tells you **what's slowing down, which app is causing it, how long cooling will take, and what to close**.
  12. <p align="center"><img src="docs/demo.gif" width="720" alt="Thermo demo: notch gauges, expanded panel, apps list and heat advisor"></p>
  13. <p align="center">📖 <a href="https://simarpreetsingh-019.github.io/Thermo/"><b>Website</b></a> · 🌡️ <a href="https://simarpreetsingh-019.github.io/Thermo/mac-temperature.html"><b>How to check your Mac's temperature</b></a> · 🤖 <a href="https://simarpreetsingh-019.github.io/Thermo/agents.html"><b>AI agents</b></a> · 🎬 <a href="docs/launch.mp4"><b>Watch the full launch video (1080p, 41 s)</b></a></p>
  14. - **Notch HUD:** glowing ring gauges beside the notch. Hover to expand, click 📌 to pin.
  15. - **Pull it out:** drag the notch down and it becomes a floating widget. Drop it back at the top centre to re-dock.
  16. - **Floating mode** for Macs without a notch: drag it anywhere, with magnetic edges, a corner snap, and a horizontal or vertical layout.
  17. - **Menu bar mode**, if you prefer.
  18. - **Memory tab:** shows real memory pressure and swap (not just "% used"), how much you could free, and the biggest apps with one-click quit. No fake "RAM cleaning".
  19. - **Smart alerts:** a small card appears if your Mac stays hot, memory stays tight, or an app gets stuck at high CPU, with a one-click fix.
  20. - **Health summary:** one line telling you if all is good, or what to close.
  21. - **Heat tab:** heat level, separate temperatures for CPU performance and efficiency cores, GPU, memory, SSD, battery, Wi-Fi and palm rest (read from the SMC, no admin rights), what's affected (throttling, slower builds, dropped frames), the top culprit apps (including the project folder for `node`/`python` processes), a cooldown estimate, and one-click quit.
  22. - **Apps tab:** top apps by CPU or memory, with quit buttons.
  23. - **Battery tab** (MacBooks): health as a percentage of the original capacity, condition, cycle count against the rated 1000, charge rate or drain in watts, time left, and a 24-hour charge graph. Thermo logs health once a day, so you can see how it changes over time.
  24. - **History tab:** CPU, memory, GPU and temperature graphs for the last hour or 24 hours, with a shared hover crosshair to see what happened at any moment.
  25. - **No sudo, no kernel extensions, no dependencies.** It reads sensors through public and stable macOS APIs.
  26. ## Install
  27. > **Downloading the zip?** macOS will warn that it can't verify Thermo. That's normal for free apps not notarized by Apple. [Here's how to open it safely](#first-launch-why-macos-warns-you) (one click in System Settings).
  28. **Homebrew**
  29. ```bash
  30. brew install --cask simarpreetsingh-019/thermo/thermo
  31. ```
  32. Homebrew also adds the `thermo` command: `thermo status`, `thermo temps`, `thermo headroom`, `thermo help` and more (see [Use from Terminal](#use-from-terminal)).
  33. **No Homebrew? Use the installer script.** It downloads the latest release, checks it, and installs it. Read it first, it's short:
  34. ```bash
  35. curl -fsSL https://raw.githubusercontent.com/simarpreetsingh-019/Thermo/main/install.sh -o install.sh
  36. ```
  37. ```bash
  38. bash install.sh
  39. ```
  40. It can also add the `thermo` Terminal command (it asks first). Before installing anything, it checks that the zip matches the release's SHA-256 checksum, that the GitHub attestation is valid (if you have the `gh` CLI), and that the app's signature and bundle ID are intact. If any check fails, nothing is installed.
  41. **Direct download:** grab `Thermo.zip` from [Releases](https://github.com/simarpreetsingh-019/Thermo/releases), unzip it, and drag it into Applications. See [first launch](#first-launch-why-macos-warns-you) below. For the `thermo` Terminal command, use ⚙ → Connections → **Install thermo command**.
  42. **Build from source** (needs Xcode Command Line Tools):
  43. ```bash
  44. git clone https://github.com/simarpreetsingh-019/Thermo && cd Thermo && ./build.sh --install
  45. ```
  46. Add `--no-connect` to leave out the CLI JSON output, MCP server and local API (about 0.3 MB smaller).
  47. Requires macOS 13+. It's a universal app (Apple Silicon and Intel), and Intel Macs read temperatures from the SMC (less tested there).
  48. ## First launch: why macOS warns you
  49. If you downloaded the zip, macOS will say it **can't verify** that Thermo is free of malware. That's expected, and it's macOS doing its job: Apple only vouches for apps from developers in its paid program who send every build to Apple for scanning (notarization). Thermo is a free open-source side project and isn't notarized yet. The warning means "Apple hasn't checked this", not "this is harmful".
  50. To open it once (macOS remembers your choice):
  51. 1. Double-click Thermo and click **Done** on the warning.
  52. 2. Open **System Settings → Privacy & Security**, scroll down, and click **Open Anyway** next to Thermo.
  53. 3. Confirm with your password or Touch ID.
  54. On macOS 14 and earlier, right-click Thermo → **Open** also works. Homebrew and the installer script verify the download themselves, so they skip this step.
  55. ### Check your download yourself
  56. You don't have to take our word for it:
  57. - **Checksum:** compare the result with the SHA-256 in the release notes.
  58. ```bash
  59. shasum -a 256 ~/Downloads/Thermo.zip
  60. ```
  61. - **Attestation:** GitHub signs a record of every release zip. This confirms the file was published by this repository and hasn't been swapped (needs the [GitHub CLI](https://cli.github.com)):
  62. ```bash
  63. gh attestation verify ~/Downloads/Thermo.zip --repo simarpreetsingh-019/Thermo
  64. ```
  65. - **Source:** the full code is here; build it yourself with `./build.sh` if you prefer.
  66. ## Use from Terminal
  67. Add `--json` to any reading for machine-readable output. Without Homebrew, use `/Applications/Thermo.app/Contents/MacOS/Thermo --cli <command>`.
  68. | Command | What you get |
  69. |---|---|
  70. | `thermo status` | CPU, GPU, memory, heat, battery and a one-line health summary |
  71. | `thermo temps` | temperature of each part |
  72. | `thermo apps --sort memory` | busiest apps |
  73. | `thermo battery` | health, cycles, charge, watts |
  74. | `thermo history --range 24h` | averages and peaks |
  75. | `thermo headroom --kind gpu --memory-gb 8` | room for a heavy job? exit 0 go, 3 wait, 4 no |
  76. | `thermo wait-cool --target 70` | wait until the Mac cools |
  77. | `thermo bench --process node -- npm test` | run a command; report CPU/GPU load, heat rise, throttling |
  78. | `thermo bench compare --markdown` | compare the last two runs; a before/after table for your PR |
  79. ```bash
  80. thermo headroom --kind gpu --memory-gb 12 || thermo wait-cool --target 70
  81. python train.py
  82. ```
  83. ## Connect AI agents and apps
  84. Thermo includes an **MCP server**, so Claude, Codex, Cursor, VS Code and any MCP client can **benchmark what your tests, builds and apps do to the Mac** (CPU/GPU load, memory, temperature rise, throttling) and check for headroom before heavy work. Tools: `start_benchmark`, `stop_benchmark`, `compare_benchmarks`, `list_benchmarks`, `check_headroom`, `wait_until_cool`, `get_status`, `get_temperatures`, `get_top_processes`, `get_battery`, `get_history`.
  85. ```bash
  86. claude mcp add thermo -- /Applications/Thermo.app/Contents/MacOS/Thermo --mcp
  87. ```
  88. - **Claude Code plugin** (MCP server + skill): `/plugin marketplace add simarpreetsingh-019/Thermo`, then `/plugin install thermo@thermo`
  89. - **Codex, Cursor, VS Code, Claude Desktop, others:** [integrations/](integrations/README.md)
  90. - **Your own app:** one-file clients for [Python](clients/thermo_client.py), [JavaScript](clients/thermo.mjs) and [Swift](clients/Thermo.swift)
  91. - **Local HTTP API:** opt-in (⚙ → Connections), `127.0.0.1:47615`, read-only, token-protected. [Endpoints](https://simarpreetsingh-019.github.io/Thermo/agents.html#api)
  92. - **GitHub Actions:** `uses: simarpreetsingh-019/Thermo@v1` on macOS runners. [Details](integrations/README.md#github-actions)
  93. ## Roadmap
  94. - **Windows and Linux support:** the CLI, API and MCP server first, then a tray app
  95. - Apple notarization, so downloads open without a warning
  96. - More agent integrations and MCP registry listings
  97. ## Updates
  98. Thermo checks GitHub for a new version once a day. When one is out, an orange **Update** button appears in the panel: one click downloads it, verifies it and relaunches. You can also use ⚙ → **Check for Updates…**, or `brew upgrade --cask thermo` if you installed it with Homebrew.
  99. ## Feedback
  100. I'd love to hear from you! Use ⚙ → **Send Feedback…** in the app (it fills in your version and Mac model), [open a feedback issue](https://github.com/simarpreetsingh-019/Thermo/issues/new/choose), DM me on [X](https://x.com/simarpreet_019), or email me (address in the Creator section below).
  101. ## How light is it?
  102. Measured on an M5 MacBook:
  103. | | Thermo |
  104. |---|---|
  105. | App size | **1.9 MB** |
  106. | Memory (physical footprint) | **~16 MB** |
  107. | CPU, notch collapsed | **~2.7% of one core**, about 0.3% of the whole chip |
  108. | GPU | none beyond normal window drawing |
  109. | Disk / network | writes only a few settings; one small update check per day |
  110. How it stays light:
  111. - It samples every 2 s, with timer tolerance so macOS can batch wake-ups.
  112. - The full per-process scan runs only while the Apps or Heat list is open; otherwise it runs every 8 s.
  113. - It's native Swift with no Electron, no web views and no helper daemons.
  114. ## How it works
  115. | Metric | Source |
  116. |---|---|
  117. | CPU | `host_statistics` (Mach) |
  118. | RAM | `host_statistics64` plus `vm.swapusage`, matching Activity Monitor's "Memory Used" |
  119. | GPU | IORegistry `IOAccelerator` → `PerformanceStatistics` |
  120. | Temperature | IOKit HID temperature sensors (Apple Silicon), no SMC access needed |
  121. | Per-app usage | `proc_pid_rusage`; helper processes are grouped under their parent app |
  122. | Throttling | `ProcessInfo.thermalState` |
  123. ## About the creator
  124. Thermo is designed and built by **Simarpreet Singh**, an independent developer who makes small, fast tools for Mac.
  125. - 🌐 Portfolio: [simarpreetsingh-019.github.io](https://simarpreetsingh-019.github.io)
  126. - 🐦 X / Twitter: [@simarpreet_019](https://x.com/simarpreet_019)
  127. - 💻 GitHub: [@simarpreetsingh-019](https://github.com/simarpreetsingh-019)
  128. - ✉️ Email: [simarpreetsingh.019@gmail.com](mailto:simarpreetsingh.019@gmail.com)
  129. Open to collaborations, freelance work and opportunities. Say hi!
  130. ## Support Thermo
  131. Thermo is free. If it helps you:
  132. - ⭐ **[Star the repo](https://github.com/simarpreetsingh-019/Thermo)**, it helps others find it
  133. - 📣 Share it on X, Reddit or with your team
  134. - 🐞 [Report a bug](https://github.com/simarpreetsingh-019/Thermo/issues/new?template=bug.yml) or 💡 [suggest an upgrade](https://github.com/simarpreetsingh-019/Thermo/issues/new?template=feedback.yml)
  135. ## Contributing
  136. Pull requests are welcome: fixes, sensors, agent integrations, docs, and help bringing Thermo to Windows and Linux. Start with the **[contributing guide](CONTRIBUTING.md)**; security issues go through [SECURITY.md](SECURITY.md).
  137. <a href="https://github.com/simarpreetsingh-019/Thermo/graphs/contributors"><img src="https://contrib.rocks/image?repo=simarpreetsingh-019/Thermo" alt="Contributors"></a>
  138. ## Credits and similar projects
  139. Inspired by [Stats](https://github.com/exelban/stats), [Boring.Notch](https://github.com/TheBoredTeam/boring.notch), [Atoll](https://github.com/Ebullioscopic/Atoll) and [MacThrottle](https://github.com/angristan/MacThrottle).
  140. ## License
  141. MIT
  142. ## Security
  143. - **No telemetry, no admin rights.** Thermo reads local system statistics and saves its own preferences plus a 24-hour history file (about 60 KB, in `~/Library/Application Support/Thermo`). Its only network request is a daily update check against GitHub Releases, which sends nothing about you or your Mac. You can turn it off with ⚙ → "Check for updates automatically".
  144. - **Updates are verified:** the downloaded zip must match the SHA-256 checksum published with the release, and the app inside must pass `codesign --verify` and carry Thermo's bundle ID before it replaces the installed copy.
  145. - **Stopping processes:** apps are asked to quit normally, so they can prompt you to save. Background processes are stopped only after you confirm, and only if they belong to your user account. System-critical ones (loginwindow, Dock, WindowServer and others) are never offered. Each process is re-checked just before it's stopped, so a recycled process ID can't hit the wrong program.
  146. - **Connections:** the CLI and MCP server open no network ports. The local API is off by default; when on, it listens only on 127.0.0.1, is read-only, needs a token stored in a file only you can read, and refuses requests from web pages and foreign host names. App names and project folders are shared with other tools only while ⚙ → Connections → "Share app names" is on.
  147. - **Click-outside detection** watches only *that* a mouse click happened, never where or in which app, and never keystrokes. It needs no Accessibility permission.
  148. - The app is ad-hoc signed with the hardened runtime. It isn't notarized yet; each release lists its SHA-256 checksum so you can verify the download.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.