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). |
Prerequisites
Install or upgrade the W&B CLI to the latest release using pip or uv:
pip install --upgrade wandb
uv pip install --upgrade wandb
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:
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
wandb leet symon --interval 2s
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. |
:, =, !=, >, >=, <, 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
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.
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:
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. |
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 |
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.
