A modern terminal with a built-in multiplexer: close it and your sessions keep running. Run shells and tons of AI agents across your machines, then pick them up from desktop, browser, TUI and more. Written in Rust with no UI framework: interface drawn straight on the GPU. No Electron, GPUI or webview.
title: wezterm.default_wsl_domains tags: - wsl - multiplexing
wezterm.default_wsl_domains()
{{since('20220319-142410-0fcdea07')}}
Computes a list of WslDomain objects, each one representing an installed WSL distribution on your system.
This list is the same as the default value for the
wsl_domains configuration option, which is to make
a WslDomain with the distribution field set to the name of WSL distro and the
name field set to name of the distro but with "WSL:" prefixed to it.
For example, if:
; wsl -l -v
NAME STATE VERSION
* Ubuntu-18.04 Running 1
then this function will return:
{
{
name: "WSL:Ubuntu-18.04",
distribution: "Ubuntu-18.04",
},
}
The purpose of this function is to aid in situations where you might want set
default_prog for the WSL distributions:
local wezterm = require 'wezterm'
local wsl_domains = wezterm.default_wsl_domains()
for idx, dom in ipairs(wsl_domains) do
if dom.name == 'WSL:Ubuntu-18.04' then
dom.default_prog = { 'fish' }
end
end
return {
wsl_domains = wsl_domains,
}
However, wez strongly recommends that you use chsh inside the WSL domain to make
that the default shell if possible, so that you can avoid this additional configuration!
{{since('20230320-124340-559cb7b0')}}
The default_cwd field is now automatically set to "~" to make it more
convenient to launch a WSL instance in the home directory of the configured
distribution.