RubyMine 2017.2 Help

Working with Embedded Local Terminal


Before you start working with terminal, make sure that the Terminal plugin is enabled. The plugin is bundled with RubyMine and is activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.


RubyMine features a local terminal that makes it possible to access the command line. Depending on your platform, you can work with command line prompt, Far, powershell, bash, etc. Using the terminal, you can execute any command without leaving the IDE.

Configuring embedded local terminal

The terminal settings are configurable on several pages of the Settings/Preferences dialog.

To configure the embedded local terminal options

  1. In the Settings/Preferences dialog box, open the Terminal page, and specify the following:
    • The desired shell that will run by default, the name of a session tab
    • Name of the tab a new session will be opened in, possibility to copy to clipboard etc.
    • Ability to override the RubyMine keymap.
  2. The following settings are inherited by the embedded local terminal from the IDE settings/preferences:
    • On the Keymap page, you can configure the Ctrl+C and Ctrl+V shortcuts.
    • On the editor's Appearance page - anti-aliasing and caret blinking.
      Note that the setting Use block caret is not inherited in the terminal - its caret is always block.
    • Under the editor's Color and Fonts settings, you can change the following options:
      • On the Console Fonts page - line spacing, and console fonts.
      • On the Console Colors page - console colors.
      • On the General page - selection foreground and background colors.

Running embedded local terminal

To run the console, do one of the following

  • Press Alt+F12.
  • Click the Terminal tool window button /help/img/idea/2017.2/terminal_tool_window_button.png.
  • Hover your mouse pointer over /help/img/idea/2017.2/show_tool_window_bars.png in the lower left corner of the IDE, then choose Terminal from the menu, as described in the section Tool window quick access.

Actions available in the embedded local terminal

In the embedded local terminal, you can do the following:

  • To create a new session:
    • Click /help/img/idea/2017.2/new.png on the toolbar of the terminal.
    • Right-click a session tab, and then choose Create new session on the context menu.

    A new session is presented in a separate tab:

  • Rename a tab. Right-click a tab, and choose Rename tab on the context menu.
  • Close an active session that currently has the focus. This can be done in a number of ways:
    • Click /help/img/idea/2017.2/close.png on the terminal toolbar.
    • Right-click a session tab, and then choose Close session on the context menu.
  • Use up and down arrows on your keyboard to browse through the history of entered commands.
  • Toggle between the embedded local terminal and editor by pressing Alt+F12 (View | Tool Windows | Terminal).


Open the Terminal page of the Settings/Preferences dialog, and configure the Shell path field as follows:

"[path to the git installation]\bin\sh.exe" -login -i

Do not forget the quotes around the command!

Now, when you open the new terminal in RubyMine, it will recognize git commands:


See Also

Last modified: 21 July 2017