Spark Monitor

A minimal CLI for monitoring DGX Spark resource usage. Displays only the essential metrics, simply.

Quick Start

Run directly without installing:

uvx --from git+https://github.com/blauerberg/spark-monitor spark-monitor

Or install as a persistent command:

uv tool install git+https://github.com/blauerberg/spark-monitor
spark-monitor

To upgrade:

uv tool upgrade spark-monitor

Usage

# Default (full metrics, 1-second refresh)
spark-monitor

# Custom refresh interval
spark-monitor --interval 0.5

Press Ctrl+C to exit.

tmux statusline integration

--statusline prints a single line to stdout and exits immediately, making it suitable for embedding in the tmux status bar.

spark-monitor --statusline

Add to ~/.tmux.conf:

set -g status-right '#(spark-monitor --statusline)'
set -g status-interval 5

status-interval controls how often tmux re-runs the command (in seconds). CPU usage is measured over a 0.5-second window on each invocation, so setting it below 2 is not recommended.

Installation from source

git clone https://github.com/blauerberg/spark-monitor.git
cd spark-monitor
uv sync
uv run spark-monitor

Display

• CPU: usage (bar), clock, power (N/A), temperature
  • Power is always N/A. The current driver does not expose Grace CPU power.
• RAM: usage (bar)
• GPU: usage (bar), clock, power, temperature
• GPU Processes: processes using the GPU (hidden when none)