wandb beta leet

Usage

leet [PATH] | COMMAND [ARGS]...

Description

W&B LEET: the Lightweight Experiment Exploration Tool.

A terminal UI for viewing your W&B runs locally.

Subcommands

Command	Description
wandb beta leet config	Edit LEET configuration.
wandb beta leet run	Launch the LEET TUI.
wandb beta leet symon	Launch the standalone system monitor.

W&B LEET, the Lightweight Experiment Exploration Tool, is a local terminal UI for exploring W&B runs from the command line. Use it to compare runs, inspect metric charts, browse logged images, tail console logs, and watch system metrics without leaving a terminal session.

LEET reads local .wandb run files, so you can inspect runs before syncing them to W&B. LEET is a keyboard-driven interface designed for users who work on remote systems or HPC environments using tools like SSH or tmux.

Examples

Open the default workspace:

wandb beta leet

Open a specific workspace directory:

wandb beta leet ./wandb

Open a specific run directory:

wandb beta leet ./wandb/offline-run-20260403_145048-6ao9fhns

Open a specific .wandb file:

wandb beta leet ./wandb/offline-run-20260403_145048-6ao9fhns/run-6ao9fhns.wandb

Open the standalone system monitor:

wandb beta leet symon --interval 2s

Open the config editor:

wandb beta leet config

Views

LEET has three main views: workspace, single-run, and SYMON.

Workspace View

Workspace view is the default LEET experience. It is built for comparing multiple runs from the same local wandb/ directory.

Workspace view includes:

• A runs sidebar for browsing local run folders.
• A metrics grid that overlays selected runs on the same charts.
• A system metrics pane for the highlighted run.
• A media pane for wandb.Image thumbnails.
• A console logs pane.
• A run overview sidebar with state, ID, name, project, tags, notes, environment, config, and summary values.

Use space to select or deselect a run. Selecting a run adds it to the overlaid metric charts and loads its run-specific data. Use p to pin or unpin a run. Pinning keeps that run’s metric series on top in overlaid metric charts; the run overview, system metrics, media, and console logs panes follow the run highlighted in the runs sidebar. Press enter on the highlighted run to open it in single-run view.

Selected live runs continue updating in the workspace, so you can use LEET for both post-run analysis and live monitoring.

Single-Run View

Single-run view focuses on one run. It uses the same chart engine as workspace view, but is arranged around that run:

• The main metrics grid is centered.
• The run overview sidebar is on the left.
• The system metrics sidebar is on the right.
• Media and console logs panes can be opened below the metrics grid.

Press esc to return from single-run view to the workspace.

SYMON

wandb beta leet symon opens a standalone system monitor that is not tied to a W&B run.

Use SYMON to watch local CPU, memory, disk, network, GPU, TPU, IPU, and Trainium metrics while another process is running. It uses the same system metrics chart engine as the workspace and single-run views.

Set the sampling cadence with --interval:

wandb beta leet symon --interval 500ms
wandb beta leet symon --interval 2s
wandb beta leet symon --interval 1m

Key Features

Multi-Run Comparison

Workspace mode lets you select multiple local runs and compare their metric series on the same charts. Each selected run gets a stable color. LEET also avoids base color collisions so visible runs are easier to distinguish.

The runs list uses distinct markers for unselected, selected, and pinned runs. Pinning is useful when many runs are selected and you want one run’s metric series to render on top.

Run Filtering

Press f in workspace view to filter the runs sidebar. Bare terms search across run key, display name, run ID, project, tags, and notes.

The runs filter also supports fielded queries:

Query	Matches
project:vision	Project name.
name:baseline	Display name. Aliases: run_name, display, display_name.
id:abc123	Run ID. Alias: run_id.
key:offline-run	Run directory key. Aliases: run_key, path.
tag:prod	Tags. Alias: tags.
note:debug	Notes. Alias: notes.
config:adamw or cfg:adamw	Any flattened config key or value.
cfg.lr>=1e-3	A specific nested config path. config.lr also works.
has:notes or exists:cfg.dataset	Existence check.

Supported operators are :, =, !=, >, >=, <, and <=. Numeric comparisons are useful for config values such as learning rate, batch size, or number of layers.

Use whitespace or AND for conjunction, OR or | for alternatives, and -, !, or NOT for negation. Use quotes for phrases with spaces.

Examples:

transformer
project:vision tag:baseline
cfg.lr>=1e-3 cfg.optimizer=adamw
has:notes -tag:debug
project:vision tag:baseline cfg.lr>=1e-3 -note:debug | project:nlp

While editing a filter, press tab to switch between regex and glob modes. Regex mode behaves like a case-insensitive substring search unless the query contains regex metacharacters. Glob mode supports * for any sequence and ? for any single character.

Metrics and System Metrics

LEET renders scalar metrics as terminal line charts. Use / to filter run metrics and \ to filter system metrics. Press ctrl+/ to clear the metrics filter and ctrl+\ to clear the system metrics filter.

Click a chart or move focus with w, a, s, d, or the arrow keys. Use N or pgup for the previous page, n or pgdown for the next page, and home or end to jump to the first or last page.

Press y on a focused chart to cycle chart modes:

• Run metric charts toggle log-scale Y when the chart has positive data.
• System metric charts toggle log-scale Y.
• Percentage-based system metric charts can also switch into bucketed heatmap mode.

Use the mouse wheel to zoom the focused chart. On live system metric charts, LEET defaults to a rolling tail window, which is 10 minutes by default. Zooming out reveals more history.

Right-click and drag on a chart to inspect the nearest point. Hold alt while right-clicking and dragging to inspect all visible charts at the same X position.

Media Pane

The media pane renders wandb.Image data as ANSI thumbnails directly in the terminal. It is available in both workspace and single-run views.

Open or close the media pane with 3. When the media pane is focused:

• w, a, s, d moves between media tiles.
• Arrow keys scrub the selected media series along the X-axis.
• up and down scrub by larger steps.
• home and end scrub to the first or latest frame.
• pgup and pgdown move between media pages.
• enter toggles fullscreen mode.
• esc exits fullscreen mode.

Console Logs

Open or close the console logs pane with 4. The pane shows console output for the open run in single-run view, or for the highlighted run in workspace view.

LEET assembles raw terminal output into readable log lines, including output that contains ANSI escape codes, partial lines, and carriage returns.

Run Overview

The run overview sidebar shows run metadata and logged values:

• State, run ID, display name, project, tags, and notes.
• Environment values.
• Config values.
• Summary values.

Press o to filter overview items. Press ctrl+o to clear the overview filter.

System Metrics Coverage

The system metrics pane and SYMON can display host and accelerator metrics when those metrics are available from the local run file or live sampler. Supported chart definitions include:

• CPU, per-core CPU, Apple P-core and E-core utilization, CPU frequency, CPU temperature, and CPU power.
• RAM, swap, process memory, process CPU, process thread count.
• Disk usage and disk I/O.
• Network receive and transmit throughput.
• NVIDIA GPU utilization, memory, power, temperature, clocks, errors, encoder utilization, PCIe and NVLink throughput.
• NVML GPM metrics on supported Hopper and newer NVIDIA GPUs, including SM active, SM occupancy, tensor/FP pipeline activity, and DRAM active.
• Google TPU duty cycle, tensorcore utilization, HBM usage, HLO queue size, transfer latency, and SDK-only TPU gauges when available.
• Graphcore IPU temperature, clock, power, and utilization.
• AWS Trainium and Neuron utilization and memory metrics.

Configuration

Run the config editor with:

wandb beta leet config

LEET stores configuration in wandb-leet.json. By default, the file is written under:

~/.config/wandb/wandb-leet.json

If WANDB_CONFIG_DIR is set, LEET uses that directory instead.

The config editor lets you change:

• Startup mode: workspace_latest or single_run_latest.
• Grid sizes for workspace, single-run, media, system metrics, and SYMON views.
• Which panes are visible by default.
• Color schemes for run metrics, per-plot single-run charts, system charts, run tags, and bucketed heatmaps.
• Color assignment mode: per_series or per_plot.
• System metrics live-tail window.
• Heartbeat interval for live run updates.

You can also resize the focused grid from inside LEET:

Key	Action
c	Set columns for the focused grid.
r	Set rows for the focused grid.

After pressing c or r, press a digit from 1 to 9, or press esc to cancel.

Common Config Keys

Key	Default	Description
startup_mode	workspace_latest	Initial view when launched without a run path.
metrics_grid.rows, metrics_grid.cols	4, 3	Single-run metrics grid size.
system_grid.rows, system_grid.cols	6, 2	Single-run system metrics sidebar grid size.
media_grid.rows, media_grid.cols	1, 2	Single-run media grid size.
workspace_metrics_grid.rows, workspace_metrics_grid.cols	3, 3	Workspace metrics grid size.
workspace_system_grid.rows, workspace_system_grid.cols	3, 3	Workspace system metrics grid size.
workspace_media_grid.rows, workspace_media_grid.cols	1, 2	Workspace media grid size.
symon_grid.rows, symon_grid.cols	3, 3	SYMON grid size.
color_scheme	wandb-vibe-10	Palette for workspace run metrics and run list colors.
per_plot_color_scheme	sunset-glow	Palette for single-run charts when single_run_color_mode is per_plot.
tag_color_scheme	wandb-vibe-10	Palette for tag badges in the overview sidebar.
system_color_scheme	wandb-vibe-10	Palette for system metric charts.
french_fries_color_scheme	viridis	Palette for bucketed heatmap charts.
single_run_color_mode	per_series	Color single-run charts per series or per plot.
system_color_mode	per_series	Color system charts per series or per plot.
system_tail_window_minutes	10	Default live tail window for system charts.
heartbeat_interval_seconds	15	Polling heartbeat for live runs.
workspace_overview_visible	true	Show the workspace run overview sidebar by default.
workspace_metrics_grid_visible	true	Show the workspace metrics grid by default.
workspace_system_metrics_visible	false	Show the workspace system metrics pane by default.
workspace_console_logs_visible	false	Show the workspace console logs pane by default.
workspace_media_visible	false	Show the workspace media pane by default.
left_sidebar_visible	true	Show the single-run overview sidebar by default.
right_sidebar_visible	true	Show the single-run system metrics sidebar by default.
metrics_grid_visible	true	Show the single-run metrics grid by default.
console_logs_visible	false	Show the single-run console logs pane by default.
media_visible	false	Show the single-run media pane by default.

Available color schemes include wandb-vibe-10, wandb-vibe-20, sunset-glow, blush-tide, gilded-lagoon, bootstrap-vibe, dusk-shore, clear-signal, traffic-light, viridis, plasma, inferno, magma, and cividis.

dusk-shore and clear-signal are colorblind-friendly palettes. Sequential palettes such as viridis, plasma, inferno, magma, cividis, and traffic-light work well for bucketed heatmaps.

Keyboard Shortcuts

Press h or ? inside LEET to open the in-app help screen. Shortcuts vary slightly by view.

Workspace

Key	Action
h, ?	Toggle help.
q, ctrl+c	Quit.
alt+r	Restart LEET.
esc	Focus the runs list.
enter	Open the highlighted run in single-run view.
1	Toggle metrics grid.
[	Toggle runs sidebar.
2	Toggle system metrics pane.
]	Toggle run overview sidebar.
3	Toggle media pane.
4	Toggle console logs pane.
f	Filter runs by name or metadata.
ctrl+f	Clear runs filter.
space	Select or deselect run.
p	Pin or unpin run.
/	Filter metrics.
\	Filter system metrics.
ctrl+/, ctrl+l	Clear metrics filter.
ctrl+\	Clear system metrics filter.
o	Filter run overview items.
ctrl+o	Clear overview filter.
y	Cycle focused chart mode.
c	Set columns for focused grid.
r	Set rows for focused grid.
tab, shift+tab	Cycle focus across visible panes.
w, a, s, d or arrow keys	Move within the focused pane.
N, pgup	Previous page.
n, pgdown	Next page.
home	Jump to first item, first page, or first media frame.
end	Jump to last item, last page, or latest media frame.

Single-Run

Key	Action
h, ?	Toggle help.
q, ctrl+c	Quit.
alt+r	Restart LEET.
esc	Return to workspace view.
1	Toggle metrics grid.
[	Toggle run overview sidebar.
]	Toggle system metrics sidebar.
3	Toggle media pane.
4	Toggle console logs pane.
/	Filter metrics.
\	Filter system metrics.
ctrl+/, ctrl+l	Clear metrics filter.
ctrl+\	Clear system metrics filter.
o	Filter run overview items.
ctrl+o	Clear overview filter.
y	Cycle focused chart mode.
c	Set columns for focused grid.
r	Set rows for focused grid.
tab, shift+tab	Cycle focus across visible panes.
w, a, s, d or arrow keys	Move within the focused pane.
N, pgup	Previous page.
n, pgdown	Next page.
home	Jump to first item, first page, or first media frame.
end	Jump to last item, last page, or latest media frame.

SYMON

Key	Action
h, ?	Toggle help.
q, ctrl+c	Quit.
alt+r	Restart.
y	Cycle focused chart mode.
\	Filter system metrics.
ctrl+\	Clear system metrics filter.
c, C	Set grid columns.
r, R	Set grid rows.
w, a, s, d or arrow keys	Move chart focus.
N, pgup	Previous chart page.
n, pgdown	Next chart page.
home	First chart page.
end	Last chart page.

Mouse

Input	Action
Click	Focus a chart or select a media tile.
Wheel	Zoom the focused chart.
Right-click and drag	Inspect the nearest point on a chart.
alt plus right-click and drag	Inspect all visible charts in sync.
shift plus drag	Select terminal text.

Changelog

The following table summarizes LEET changes by version. For more details, see the GitHub release notes.

Version	LEET changes
0.23.0	Initial experimental wandb beta leet command for local run metrics and system health.
0.23.1	Regex filters for metrics and the run overview, chart inspection with right-click drag, synchronized chart inspection with alt, and better negative Y-axis tick display and system metric units.
0.25.0	Multi-run workspace view and wandb beta leet config editor.
0.25.1	Console logs pane, workspace system metrics pane, and system metrics filtering.
0.26.0	Metadata-aware run filtering, tags and notes in overview, per-chart log Y, SYMON, bucketed heatmaps, colorblind-friendly palettes, media pane, improved system metrics overlays/inspection/zoom, and workspace run color collision prevention.
0.26.1	Unified navigation across focused panes with w/a/s/d, arrows, home, end, pgup, and pgdown.