gpulse v2.2 is out. This release focuses on the first-run experience and configuration management — making gpulse easier to get started with and safer to configure.

Onboarding Wizard

The first time you run gpulse dashboard, a 4-question onboarding wizard now walks you through initial setup:

Theme — choose from 15 built-in themes (Monokai is the default). Includes colorblind-safe options.
Default view — pick which view mode to open on launch (Grid, Detail, List, etc.).
Refresh rate — set how frequently metrics update (default: 1 second).
Notifications — configure whether you want desktop notifications for leak detection alerts.

Your choices are saved to config.toml and applied automatically on every subsequent launch. No more editing config files manually to change basic preferences.

gpulse config Command

Want to change your preferences later? The new gpulse config command re-runs the onboarding wizard at any time. It reads your current settings, lets you modify them, and writes the updated config.toml.

gpulse config

This is the recommended way to manage your gpulse configuration. It validates inputs, handles default values, and ensures the config file is well-formed. For advanced users, you can still edit config.toml directly — see the configuration documentation for the full reference.

Security: 0600 Permissions and Atomic Writes

The config file now has stricter security defaults:

File permissions — config.toml is created with 0600 permissions (owner read/write only). Other users on the system cannot read your configuration.
Atomic writes — configuration changes are written to a temporary file first, then atomically renamed to the final path. This prevents corruption if gpulse is interrupted during a write (e.g., by a power failure or kill signal).
Safe defaults — the onboarding wizard sets reasonable defaults for all settings, so you do not need to understand every option to get started.

These changes are particularly relevant if you are running gpulse on shared machines or in environments where config file integrity matters.

Other Improvements

Left/Right arrow keys now work for GPU cycling in all view modes, not just Grid.
The Detail view title now shows a GPU counter and navigation hint (e.g., "GPU 2/8 — Left/Right to cycle").
Default theme changed from Dark to Monokai for a better out-of-the-box experience.
Various bug fixes and performance improvements.

Upgrade

If you installed via Homebrew:

brew update && brew upgrade gpulse

New to gpulse? See the getting started guide. The install is a single command, and the onboarding wizard will walk you through the rest.