Skip to content

mlxtop v2.1.1

Choose a tag to compare

View all tags
@maximpri maximpri released this 09 Oct 15:51
· 20 commits to main since this release
v2.1.1
32ae1f0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

mlxtop 2.1.1

Stable release for Apple Silicon macOS and Linux. Overview now leads with the host resources that decide whether a local model keeps its speed, and every chart is colored by its thresholds.

What's new

  • Host resources first: memory pressure with RAM composition (wired, app, compressed, cache, free) and the GPU wired limit, a new macOS compression chart (compress + decompress traffic, stored vs compressor bytes and ratio) and paging lead Overview. Prompt load follows; generation, prefill and GPU become a compact row. All rows share one aligned three-column grid, and tall terminals give extra height to the host resources.
  • A clear verdict: the assessment reads Healthy · no bottleneck when nothing needs action and names the next check when something does. Critical alarms replace the assessment without hiding SYSINFO.
  • Threshold colors everywhere: GPU, paging, compression, memory and cache use their configured bands; generation and prefill are graded against their rolling baseline (yellow at −10%, red at −30%). Charts, assessment and Journal agree.
  • d Diagnostics and mlxtop doctor explain the assessment, the selected runtime and endpoint, authentication status and setup steps.
  • Easier reading: prompt timestamps in local time like Journal, each reading shown once, labeled cache readings (CACHED, interval, SERVER TOTAL), full view names and units at 80 columns, and consistent empty states.

Install or upgrade

curl -fsSL https://raw.githubusercontent.com/maximpri/mlxtop/main/scripts/install.sh | sh

Restart existing mlxtop sessions after upgrading. Existing configuration, oMLX settings and usage JSONL files remain compatible. Set MLXTOP_VERSION=2.1.1 to pin this release.

GPU utilization of 90% or more is shown in red (saturated) but never rings the alarm; the assessment reports the GPU only with a measured slowdown. The compression chart is macOS-only; Linux shows memory and paging.

Downloads

  • Apple Silicon macOS: native DMG installer or tar.gz archive. Requires macOS 11 or later; tested locally on macOS 27.0.1. The installer is unsigned and not notarized.
  • Linux x86_64 and ARM64: static musl tar.gz archives without runtime library dependencies.
  • SHA256SUMS covers all four downloads. Packages include documentation, the usage recorder and dependency license texts.

Validation

  • macOS: 291 Rust tests and 13 Python tests passed; production line coverage 95.6% against a 90% minimum.
  • Linux: 289 Rust tests passed on each architecture in Docker. ARM64 ran natively; x86_64 ran under emulation with two test threads, because two local-HTTP-server tests time out under full emulated parallelism. GitHub CI also passed tests and coverage natively on macOS and Ubuntu.
  • Formatting, Clippy, ShellCheck, dependency license checks, release builds and static-report smoke tests passed.
  • Overview was checked in real terminal frames from 80×24 to 250×80, including idle, empty, alarm and critical states, and against a live oMLX server on an Apple Silicon Mac Studio through release candidates rc.2–rc.5. NVIDIA per-card telemetry uses fixtures; physical NVIDIA hardware was not available.
  • Optimized binaries, archive contents, the DMG installer payload and SHA-256 checksums were verified.

README · User guide · Changelog

Assets 7
Loading