> ## Documentation Index > Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt > Use this file to discover all available pages before exploring further. # wandb beta leet export const GitHubLink = ({url}) => GitHub source ; ## Usage ```bash theme={null} 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`. W&B LEET workspace view with runs, metrics, system metrics, media, console logs, and run overview panes. ## Examples Open the default workspace: ```bash theme={null} wandb beta leet ``` Open a specific workspace directory: ```bash theme={null} wandb beta leet ./wandb ``` Open a specific run directory: ```bash theme={null} wandb beta leet ./wandb/offline-run-20260403_145048-6ao9fhns ``` Open a specific `.wandb` file: ```bash theme={null} wandb beta leet ./wandb/offline-run-20260403_145048-6ao9fhns/run-6ao9fhns.wandb ``` Open the standalone system monitor: ```bash theme={null} wandb beta leet symon --interval 2s ``` Open the config editor: ```bash theme={null} 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. W&B LEET single-run view with run overview, metric charts, and system metrics panes. 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`: ```bash theme={null} wandb beta leet symon --interval 500ms wandb beta leet symon --interval 2s wandb beta leet symon --interval 1m ``` W&B LEET system metrics view with GPU charts and bucketed heatmap mode. ## 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: ```text theme={null} 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. W&B LEET workspace view with the media pane showing several image series. ### 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: ```bash theme={null} wandb beta leet config ``` LEET stores configuration in `wandb-leet.json`. By default, the file is written under: ```text theme={null} ~/.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. W&B LEET config editor showing grid settings, color schemes, visibility settings, and palette selection. 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](https://github.com/wandb/client/releases). | 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`. |