Skip to content

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.

2.6 KB
Raw Blame

Installing on macOS

macOS 14 (Sonoma) or later is required. The app bundle declares that minimum, so earlier systems refuse to launch it rather than failing later in a way that is harder to diagnose.

The package is a Universal binary with support for both Apple Silicon and Intel hardware.

[:simple-apple: Download for macOS :material-tray-arrow-down:]({{ macos_zip_stable }}){ .md-button } [:simple-apple: Nightly for macOS :material-tray-arrow-down:]({{ macos_zip_nightly }}){ .md-button }

  1. Download Release.
  2. Extract the zipfile and drag the WezTerm.app bundle to your Applications folder.
  3. First time around, you may need to right click and select Open to allow launching the application that you've just downloaded from the internet.
  4. Subsequently, a simple double-click will launch the UI.
  5. To use wezterm binary from a terminal emulator, like wezterm ls-fonts you'll need to add the location to the wezterm binary folder that exists inside the WezTerm.app, to your environment's $PATH value. For example, to add it to your ~/.zshrc file, and assuming your WezTerm.app was installed to /Applications, add:
PATH="$PATH:/Applications/WezTerm.app/Contents/MacOS"
export PATH
  1. Configuration instructions can be found here

Homebrew

WezTerm is available for brew users:

$ brew install --cask wezterm

If you'd like to use a nightly build:

$ brew install --cask wezterm@nightly

!!! note For users who have previously used the cask named wezterm-nightly, homebrew has started issuing warnings: Warning: Cask homebrew/cask-versions/wezterm-nightly was renamed to wezterm@nightly. We recommend that you use brew uninstall wezterm-nightly to uninstall the previously installed version, and then reinstall the new version using the command above.

to upgrade to a newer nightly (normal brew upgrade will not upgrade it!):

$ brew upgrade --cask wezterm@nightly --no-quarantine --greedy-latest

!!! note The --greedy-latest option in Homebrew forces the latest version of a formula to be installed, even if a version satisfying the formula's requirements is already installed. This can be useful when you want to ensure you have the most up-to-date version of a package, regardless of whether an older version meets the current dependency requirements.

MacPorts

WezTerm is also available via MacPorts:

$ sudo port selfupdate
$ sudo port install wezterm