Supported Shells
Warp supports popular shells across macOS, Windows, and Linux. On macOS and Linux, this includes bash, zsh, fish, and PowerShell (pwsh). On Windows, this includes PowerShell 5 & 7, WSL2, and Git Bash.
Warp default shell
Warp tries to load your login shell by default. Currently, Warp supports bash, fish, zsh, and PowerShell (pwsh). If your login shell is set to something else (e.g. Nushell) Warp will show a banner indicating it's not supported and load the default shells listed below:
On macOS, zsh is the default shell.
On Windows, PowerShell (pwsh) is the default shell.
On Linux, bash is the the default shell.
Changing what shell Warp uses
To change the default shell, e recommend you choose a shell in Warp by going to Settings > Features
and scrolling to the Session
section, then select the "Startup shell for new sessions"
Customizing Your Shell Environment
Customize Your zsh Shell Environment
Zsh can be customized via the ~/.zshrc
file, which runs whenever a new session starts (window, tab, or pane). Use it to set environment variables, aliases, and customize the prompt.
Editing the .zshrc File
Edit ~/.zshrc
using nano ~/.zshrc
or vi ~/.zshrc
.
Reloading the zshrc File
Apply changes by running source ~/.zshrc
or restarting Warp/opening a new session.
Customize Your Bash Shell Environment
Bash is pre-installed on macOS and can be customized using ~/.bashrc
(for non-login shells) or ~/.bash_profile
(for login shells). Use these files to set environment variables, aliases, and customize the prompt.
Editing the .bashrc File
Edit ~/.bashrc
using nano ~/.bashrc
or vi ~/.bashrc
.
Reloading the bashrc File
Apply changes by running source ~/.bashrc
or restarting Warp/opening a new session.
Customize Your Fish Shell Environment
Fish is a user-friendly shell with autosuggestions and syntax highlighting. Its configuration file is ~/.config/fish/config.fish
.
Editing the config.fish File
Edit ~/.config/fish/config.fish
using nano ~/.config/fish
. Use it to set environment variables, aliases, and functions.
Reloading the config.fish File
Apply changes by running source ~/.config/fish
or restarting Warp/opening a new session.
Customize Your PowerShell Shell Environment
PowerShell can be customized via its profile script, located at $PROFILE
. Check if it exists with Test-Path $PROFILE
, and create it if needed with New-Item -Path $PROFILE -ItemType File -Force
.
Editing the PowerShell Profile
Edit the profile using code $PROFILE
, and use it to set environment variables, aliases, custom prompts, and scripts.
Reloading the PowerShell Profile
Apply changes by restarting Warp or opening a new session.
Additional shell guidance for macOS
Setting up zsh on Warp
By default, macOS ships with zsh located in /bin/zsh
. You can confirm this location by typing which zsh
in Warp. You can also check the version of zsh installed on your system by simply typing the following:
$ zsh --version
Using fish shell with Warp on macOS
Step 1: Install fish
While bash, and zsh come pre-installed on macOS systems, fish shell does not. So before using fish with Warp, you will need to install it. Install fish 3.6 or above using one of the methods listed below -
With Homebrew: If you already have homebrew installed, you can simply type
brew install fish
, and follow the instructions.Download the installer at fishshell.com
Step 2: Switch to fish as the default shell
Once you’ve installed fish on your computer, you can set it as your default shell, so Warp will use it every time a new tab, pane, or window is opened. You can either make fish the default shell for only Warp, from the session settings (Settings > Features > Session
), or for your user account. To change your account's default shell, you need to run two commands.
If you used Homebrew to install fish on a macOS or if you used the Mac installer available on fishshell.com to install fish, type the following two commands in Warp:
echo $(which fish) | sudo tee -a /etc/shells
chsh -s $(which fish)
Using PowerShell (pwsh) with Warp on macOS
Step 1: Install PowerShell
While bash, and zsh come pre-installed on macOS systems, PowerShell shell does not. So before using PowerShell with Warp, you will need to install it. Install PowerShell 7.0 or above using one of the methods listed below -
With Homebrew: If you already have homebrew installed, you can simply type
brew install powershell/tap/powershell
, and follow the instructions.Download from the official Microsoft website.
Step 2: Switch to pwsh as the default shell
Once you’ve installed PowerShell on your computer, you can set it as your default shell, so Warp will use it every time a new tab, pane, or window is opened. You can either make pwsh the default shell for only Warp, from the session settings (Settings > Features > Session
), or for your user account. To change your account's default shell, you need to run two commands.
echo $(which pwsh) | sudo tee -a /etc/shells
chsh -s $(which pwsh)
Using Warp with shells on Windows
On Windows, Warp's default shell is PowerShell 7 (pwsh). Warp for Windows supports several shells:
PowerShell 7 (default)
PowerShell 5
Windows Subsystem for Linux (WSL2)
Git Bash
Last updated
Was this helpful?