WebStorm 2020.1 Help


WebStorm includes an embedded terminal emulator for working with a command-line shell from inside the IDE. Use it to run Git commands, set file permissions, and perform other command-line tasks without switching to a dedicated terminal application.

Initially, the terminal emulator runs with your default system shell, but it supports many other shells such as Windows PowerShell, Command Prompt cmd.exe, sh, bash, zsh, csh, and so on. For information about changing the shell, see Configure the terminal emulator.

Open the Terminal tool window

  • Select View | Tool Windows | Terminal from the main menu or press Alt+F12.

By default, the terminal emulator runs with the current directory set to the root directory of the current project. You can change the default start directory on the Tools | Terminal page of WebStorm settings Ctrl+Alt+S.

Alternatively, you can right-click any file (for example, in the Project tool window or any open tab) and select Open in Terminal from the context menu to open the Terminal tool window with a new session in the directory of that file.

Start a new session

  • Click the Add button on the toolbar to start a new session in a separate tab.

    New session in the terminal

To run multiple sessions inside a tab, right-click the tab and select Split Vertically or Split Horizontally in the context menu.

The Terminal saves tabs and sessions when you close the project or WebStorm. It preserves tab names, the current working directory, and even the shell history.

To close a tab, click the Close button on the Terminal toolbar or right-click the tab and select Close Tab from the context menu.

Press Alt+Right and Alt+Left to switch between active tabs. Alternatively, you can press Alt+Down to see the list of all terminal tabs.

To rename a tab, right-click the tab and select Rename Session from the context menu.

To search for a certain string in a Terminal session, press Ctrl+F. This searches all text in the session: the prompt, commands, and output.

Configure the terminal emulator

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Tools | Terminal.

  2. Specify the desired shell to use with the embedded terminal emulator, change the start directory, and define environment variables among other settings.

    In case you want to use an alternative shell, here are some example paths you can configure:

    • PowerShell: powershell

    • Cmder: "cmd" /k ""%CMDER_ROOT%\vendor\init.bat"" (make sure to set the CMDER_ROOT environment variable)

    • Cygwin: "C:\cygwin\bin\bash.exe" --login -i

    • Zsh: /bin/zsh

    • Bash: /bin/bash

    • Bash for Windows: bash.exe

The embedded terminal emulator also inherits the following IDE settings:

  • On the Keymap page, you can configure the copy Ctrl+C and paste Ctrl+V shortcuts.

  • On the Editor | General | Appearance page, you can configure blinking frequency for the caret. The Terminal does not inherit the Use block caret option because it always renders the caret as a block.

  • On the Editor | Color Scheme | Console Font page, you can configure line spacing and fonts.

  • On the Editor | Color Scheme | Console Colors page, you can configure font colors.

  • On the Editor | Color Scheme | General page, you can configure the selection foreground and background colors.

Last modified: 8 April 2020