LEET terminal UI

Explore and compare local W&B runs from the terminal with the LEET (Lightweight Experiment Exploration Tool) TUI.

W&B LEET (Lightweight Experiment Exploration Tool) is a keyboard-driven terminal UI for exploring runs logged on the machine where you work. Use LEET to compare metrics, inspect system utilization, browse logged images, and tail console output without opening a browser. LEET reads local .wandb transaction logs, so you can inspect runs before they sync to the cloud.

When to use LEET

LEET is built for engineers who spend most of their time in a terminal, especially on remote machines, clusters, or SSH sessions where a graphical browser is slow or unavailable.

Surface	Best for
LEET	Local run folders on the machine that logged them; fast keyboard navigation; live monitoring while a job is still writing logs; SSH and tmux workflows.
W&B App	Full project workspaces, team collaboration, reports, sweeps, artifacts, and rich panel types across synced cloud runs.
W&B mobile app	Lightweight monitoring and alerts for synced cloud projects on a phone (Multi-tenant Cloud only).

LEET and the W&B App show the same underlying run data when that data exists locally and has been synced. LEET does not replace a project workspace in the browser. It is a different interface over local run files and live updates from an active training process.

Prerequisites

Install or upgrade the W&B CLI to the latest release using pip or uv:

pip

pip install --upgrade wandb

uv

uv pip install --upgrade wandb

This guide tracks the latest CLI behavior. For version-by-version changes, see the changelog on this page.

In SDK v0.27.x and earlier, launch the LEET TUI with wandb beta leet instead of wandb leet.

Launch LEET

From the directory that contains your wandb/ folder, open the default workspace and auto-select the latest local run:

wandb leet

You can pass an optional PATH that points to a workspace directory, a specific run directory, or a .wandb file:

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

Open the standalone system monitor (SYMON) to view host metrics without a run context:

wandb leet symon --interval 2s

For command syntax and subcommands, see wandb leet in the CLI reference.

Views and pane layout

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

Workspace view

Workspace view is the default. It is designed to compare multiple runs from the same local wandb/ directory.

Typical panes include:

• Runs sidebar — browse and filter local run folders.
• Metrics grid — overlay selected runs on the same scalar charts.
• System metrics — charts for the highlighted run.
• Media — wandb.Image thumbnails rendered in the terminal.
• Console logs — assembled stdout and stderr for the highlighted run.
• Run overview — state, IDs, tags, notes, config, and summary values.

Use space to select or deselect a run for overlaid metrics. Selected runs have a filled icon. Use p to pin a run so its series stays on top in metric charts. Press enter on the highlighted run to open single-run view. Live runs keep updating in the workspace, so you can use LEET for both post-run analysis and monitoring an active job.

Single-run view

Single-run view focuses on one run with a metrics grid in the center, run overview on the left, and system metrics on the right. Media and console log panes open below the metrics grid when toggled on.

Press esc to return to workspace view.

SYMON

SYMON watches local CPU, memory, disk, network, and accelerator metrics. It uses the same chart engine as run-backed system metrics panes but is not tied to a W&B run file.

Key features

Multi-run comparison

Select multiple runs in workspace view to compare scalar metrics on shared charts. Each run gets a stable color, and LEET reduces base color collisions so overlaid series stay distinguishable. Pinning is useful when many runs are selected and you want one series to render above the rest.

Press f to filter the runs list by name, project, tags, notes, config values, and other metadata. Bare terms search across run key, display name, run ID, project, tags, and notes. The 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.

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. Filter run metrics with / and system metrics with \. Press y on a focused chart to cycle modes such as log-scale Y or bucketed heatmap views for percentage-based system metrics.

Use the mouse wheel to zoom the focused chart. On live system metric charts, LEET defaults to a rolling tail window (10 minutes by default). Right-click and drag on a chart to inspect the nearest point. Hold alt while dragging to inspect all visible charts at the same X position.

Media and console logs

The media pane shows wandb.Image series as ANSI thumbnails. Toggle it with 3 in workspace or single-run view.

Toggle console logs with 4. LEET rebuilds readable log lines from raw terminal output, including ANSI escape codes and carriage-return progress lines.

For console log behavior in the W&B App, see Console logs.

Configuration

Persist layout, colors, default panes, and startup mode with the config editor:

wandb leet config

LEET writes wandb-leet.json under ~/.config/wandb/ by default, or under WANDB_CONFIG_DIR when that variable is set. You can also resize grids from inside LEET with c and r.

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.

Several color schemes are available, like 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.

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

Navigate with the keyboard

LEET is designed for keyboard and mouse input. Press h or ? inside LEET to open the in-app help overlay for the current view.

Across workspace and single-run views:

• tab and shift+tab cycle focus between visible panes.
• w, a, s, d and the arrow keys move within the focused pane (except in the media pane, where arrows scrub the X-axis and WASD moves between tiles).
• home, end, pgup, and pgdown jump within lists, chart pages, or media frames.
• 1, 2, 3, and 4 toggle the metrics grid, system metrics, media, and console logs panes.
• [ and ] toggle sidebars (runs list, run overview, or system metrics depending on the view).

For the full shortcut tables for workspace, single-run, SYMON, and mouse actions, see Keyboard shortcuts (LEET tab).

Limitations compared to the W&B App

LEET complements the W&B App but does not replicate every workspace capability.

Capability	LEET	W&B App
Data source	Local wandb/ directories and .wandb files on the current machine	Synced cloud projects and teams
Run comparison	Multiple local runs in one directory	Full workspace tables, grouping, and saved views
Panel types	Scalar line charts, system metrics, wandb.Image media, console logs	Line, bar, scatter, parallel coordinates, media, code, query panels, custom charts, and more
Collaboration	Single-user terminal session	Sharing, comments, reports, and team features
Artifacts and files	Not available	Artifacts, Files, and Code tabs per run
Sweeps and registry	Not available	Sweep dashboards, registry, and automations

If you need artifacts, sweep analysis, or panel types that LEET does not provide, open the run in the W&B App after syncing.

Changelog

LEET was initially launched in beta in SDK v0.23.0, and graduated to GA in SDK v0.28.0. For details, refer to the SDK release notes.

Related resources

• View a specific run in the W&B App or LEET.
• Keyboard shortcuts for the W&B App and LEET.
• wandb leet command reference.
• SDK release notes, including LEET changes.