Skip to content

mlxtop v1.2.0

Choose a tag to compare

@maximpri maximpri released this 30 Sep 14:46
· 70 commits to main since this release
a9bf90f

mlxtop 1.2.0

Stable release of the Linux NVIDIA multi-GPU dashboard and interactive chart controls.

  • See each NVIDIA card's utilization, VRAM and temperature in Overview. Select cards with [ / ]; missing measurements remain unavailable.
  • Select charts with Tab, arrows or a click, zoom history with + / - or the mouse wheel, and enlarge or restore a chart with Enter / Esc. Change the sampling interval with { / }.
  • Prompt load shows exact input-token counts, including cached tokens, with request freshness, recent median and range.
  • Diagnostics show measured slowdowns and their evidence. High GPU utilization alone does not trigger an alarm.
  • Critical memory pressure and severe paging ring the terminal bell once per episode. Press a to acknowledge.
  • Linux temperatures are displayed without inferring thermal throttling from a fixed threshold.

There are no functional changes from 1.2.0-rc.2.

Install

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

The terminal installer selects the latest stable release and checks its SHA-256 checksum. Set MLXTOP_VERSION=1.2.0 to pin this release.

Downloads

  • Apple Silicon macOS: DMG with native installer, or a tar.gz archive. Requires macOS 11 or later; tested on macOS 27.0. The installer is unsigned and not notarized.
  • Linux: static musl archives for x86_64 and aarch64, with no runtime library dependencies.
  • SHA256SUMS covers all four downloads. Each package includes documentation and dependency license texts.

Validation

All 147 Rust tests passed on macOS, and all 145 Rust tests passed on each Linux architecture. Formatting, Clippy, four Python helper tests, shell checks and dependency license checks passed. Optimized binaries reported mlxtop 1.2.0 and completed static-report smoke checks. Archive contents, the DMG package version and binary, and download checksums were verified.

Linux builds and tests ran in Docker; x86_64 ran under emulation on Apple Silicon. NVIDIA behavior is covered by fixtures; physical NVIDIA hardware was not available.

Changelog · User guide