Skip to content

Changelog

All notable changes to fm are documented here. The format follows Keep a Changelog, and the project adheres to Semantic Versioning.

[0.3.2] — 2026-09-13

Added

  • Automatic self-update — a background PyPI check (≤ every 12h, daemon thread, never blocks launch); when a newer release is cached, the next launch upgrades in place (git pull --ff-only for clones, pipx upgrade / pip install -U otherwise) and re-execs. Failures warn once and launch the current version. Opt out via fm update --off, FANMON_NO_UPDATE=1, or the [update] auto = false config table; fm update / fm update --check give manual control. The TUI notifies once when an update is pending.
  • Quick start / Updates docs; install.sh now fails fast on Python <3.11, honours PYTHON=, and prints the fm ai setup hint.

[0.3.1] — 2026-09-13

Added

  • Interactive AI tab — space toggles close actions for a batch kill, enter runs investigate/wait rows as tool-using follow-up consults, quick-reply follow-up questions are selectable options, and a post-kill "verifying…" consult checks whether the advice helped. All kills still go through the same human-confirmed prompt.
  • fm ai … subcommands — providers (omp + Ollama + LM Studio detection), setup (scriptable config writer, --from-omp, --force guarded), status, test [--tools], enable/disable.
  • key_source = "none" for key-less local providers (Ollama, LM Studio); the Authorization header is then omitted.

[0.3.0] — 2026-09-13

Added

  • AI harness (opt-in) — a new AI tab consults an OpenAI-compatible chat model with a read-only tool loop (proc_detail, process_tree, resample, recent_logs, thermal_state, watchdog_events). a asks on the latest snapshot, A opens a setup wizard that detects providers from ~/.omp/agent/models.yml, and an inline input takes follow-up questions.
  • Threshold triggers — fan duty, CPU throttle, memory and swap %, or a streak of high verdicts can auto-start a consult; each rule fires once, then cools down and must drop below 85% of threshold to re-arm.
  • fm --once --ai [--ask "question"] — prints the deterministic snapshot followed by an AI diagnosis panel.
  • Config file ~/.config/macos-fanMonitor/config.toml (override with FANMON_AI_CONFIG). The API key is never stored — key_source points at an omp provider or an env var.
  • make test-unit — stdlib unittest suite for the AI harness.

Privacy & safety

  • The snapshot packet sends comm + category only — never a full command line.
  • The AI recommends only: close actions are validated against closeable, non-system pids and appear as rows the user confirms via the existing k → confirm → SIGTERM path.

Changed

  • Requires Python 3.11+ (stdlib tomllib).

0.2.0 — 2026-09-02

Built for the Agentic Builders Collective, and for its MacBook Air owners, who pointed out they had no fan to monitor.

Added

  • MacBook Air / fanless support — fm detects a fanless machine from the SMC fan count, retitles the FAN tile to COOLING, and reads the CPU speed limit from pmset -g therm. Verdict language adapts to fanless hardware.
  • 🌡️ Thermal verdict — a new regime for "no single hog, but macOS is throttling the clock"; severity watch under 30% throttle, high above.
  • CPU tab — per-core bars labelled P (performance) / E (efficiency) via Mach host_processor_info, user / system split, a session sparkline, and the top 14 processes by real CPU delta. k works here.
  • Memory tab — Activity-Monitor-style breakdown (app / wired / compressed / cached / swap), memory-free %, page-in/out rates, a session sparkline, and the top 14 by resident memory. k works here.
  • CPU tile replaces the LOAD tile: total busy %, P vs E %, one glyph per core; load average moves to its detail line.
  • MEMORY tile now leads with RAM used of total; swap and compressor ratio move to the detail lines.
  • [ / ] cycle tabs.
  • Animated ABC boot screen — the sliced wordmark assembles in the community's peach → coral palette while initial hardware sampling runs in the background. It remains visible for at least three seconds, then the persistent header reads Fan Monitor - Agentic Builders Collective. --no-anim or FANMON_NO_ANIM=1 skips it.
  • FANMON_FANLESS=1 and FANMON_THROTTLE=<pct> environment hooks to simulate an Air on any Mac; the smoke test runs both modes.
  • fm --once gains the wordmark header, CPU-cores and Memory panels.

Changed

  • ABC branding — the full sliced ABC wordmark owns the boot sequence, the community name remains in the header, the TUI ships an abc Textual theme, and the logo's peach → coral gradient is the heat scale on every gauge (sage = fine, peach = warm, coral = hot).
  • Stats.app is now optional: without it the FAN and TEMP tiles say so, and everything else works.
  • Verdict copy is hardware-aware ("fan is spinning" vs. "your Mac is hot").
  • Kill handling is table-agnostic; the confirm modal is reachable from Close, CPU, Memory and Processes.

Docs

  • README, index and user guide rewritten around the ABC identity, the Air story, and the new tabs; the README embeds a 20-second animated demo and real TUI screenshots live under docs/assets/.

0.1.0 — 2026-09-02

First release.

Added

  • Regime detection — distinguishes a spinning fan caused by genuine CPU load from one caused by memory/swap thrash (high load, low CPU, processes blocked on disk). Also detects mixed and nominal.
  • Textual TUI — live fan/temp/load/memory gauges, a colour-coded Verdict naming the cause, and Close / Processes / Watchdog tabs.
  • Recommendation engine — ranks closeable processes with regime-weighted scoring (memory regime weights RAM + age; CPU regime weights CPU%), grouped by swarm session so multi-agent sets collapse to one row.
  • Process classification — agent / browser / chat / app / system, with system daemons surfaced as advisories, never as kill targets.
  • Confirm-gated kill — k prompts, re-checks PID liveness, and sends SIGTERM only (never SIGKILL, never automatic).
  • Real CPU-time delta sampling instead of the stale ps %cpu lifetime average.
  • Watchdog integration — read-only fan-event history, live probe status, and trigger/re-arm thresholds from the dev.jensen.watchdog files.
  • fm --once non-interactive snapshot mode for scripts and quick looks.
  • Headless smoke test (smoke_test.py) via Textual's run_test() pilot.
  • Documentation site (MkDocs Material) published to GitHub Pages, plus this changelog and a MIT license.

Design notes

  • Not a Docker app — containers run in a Linux VM and cannot reach the macOS SMC (fan/temps), the host process list, or vm_stat. A native tool is the only correct way to see host fan causes.
  • Fan/temp readings reuse Stats.app's read-only SMC helper, so no new privileged code is introduced.