Seamless VS Code Integration

VS Code Terminal

To run Cmder shell as the VS Code terminal, follow the instructions below:

👉 Note: Before you continue, make sure to update both VS Code and Cmder to the latest versions respectively, as the configuration has been changed in the recent versions.

Press Ctrl + , (Control-Comma) to access VS Code Settings, search for terminal profiles windows, then click Edit in settings.json.

✅ Tip: You can also open the settings.json file from Command Pallet (Ctrl + Shift + P), type settings.json and then hit Enter.
In the settings.json file, append or modify the following terminal profile for Cmder into your configuration file:

👉 Note: Please make sure that the CMDER_ROOT environment variable is configured to the correct installation directory first. Alternatively, you can also substitute the %CMDER_ROOT% variable with the path to your Cmder installation, although this is not recommended.
```
    "terminal.integrated.defaultProfile.windows": "Cmder",

    "terminal.integrated.profiles.windows": {
        "Cmder": {
            "name": "Cmder",
            "path": [
                "${env:windir}\\Sysnative\\cmd.exe",
                "${env:windir}\\System32\\cmd.exe"
            ],
            "args": ["/k", "${env:cmder_root}\\vendor\\bin\\vscode_init.cmd"],
            "icon": "terminal-cmd",
            "color": "terminal.ansiGreen"
        },
    },
```
example of using an absolute path instead of CMDER_ROOT variable:
```
"args": ["/k", "C:\\Cmder\\vendor\\bin\\vscode_init.cmd"]
```
The configured values will produce a default Cmder terminal using Cmd.exe (i.e. clink) shell, as if you launched Cmder.exe.

Tip: The terminal.integrated.profiles.windows and terminal.integrated.defaultProfile.windows configs are only valid with Windows-based shells and will have no effect on other operating systems such as Linux and macOS, so you can safely share your VS Code config across different machines.

✅ Note the double backslashes which are required. Alternatively, you can use a single forward slash (/) instead of double slashes (\\) to specify the path.

Also note that in the path value, cmd.exe must be used instead of cmder.exe. See more information for details.
Press Ctrl + ` (Control-Tilde) to open VS Code's integrated terminal.

👉 Note: Cmder and VS Code both have a hotkey mapping for Ctrl + ` (Control-Tilde). You need to change Cmder's mapping if you want to use VS Code's mapping. You can read more information about that.

A generic vscode_init_args.cmd is created in one of the paths below on the first run of vscode_init.cmd, if it does not already exist. This file is run every time you open VS Code's integrated terminal to access Cmder.

Edit either the %cmder_root%\bin\vscode_init_args.cmd or the %cmder_user_bin%\vscode_init_args.cmd script to set appropriate Cmder settings for VS Code according to the internal documentation present in the script.

User-configured Cmder vscode_init_args.cmd example:

@echo off
echo Applying Cmder VSCode settings from '%~0'...

if defined CMDER_CONFIGURED (
    rem Set Cmder settings here for when VSCode is launched inside Cmder.
    rem The below causes Cmder to not rerun '%cmder_root%\config\profile.d\*.cmd' or 'user_profile.cmd' scripts because Cmder already ran them.
    set CMDER_CONFIGURED=2
) else (
    rem Set Cmder settings here for when VSCode is launched from outside Cmder.
    rem Do NOT add optional Unix tools to the path the same as 'init.bat /nix_tools=0'
    set nix_tools=0
    rem Enable Cmder `fast_init` same as 'init.bat /f'
    set fast_init=1

    rem Enable Cmder User config same as 'Cmder.exe /c c:\Users\%USERNAME%\.cmder'
    rem NOTE: This is non-default config and results in a non-portable config.
    rem       This is for example purposes only and should only be done if you understand WHY this is done!
    set cmder_user_bin=c:\Users\%USERNAME%\.cmder\bin
    set cmder_user_config=c:\Users\%USERNAME%\.cmder\config
)

set verbose_output=1

rem Set all required Cmder VSCode terminal environment settings above this line.
echo Applying Cmder VSCode settings is complete!

Close the previous VS Code Cmder terminal by typing exit and then press Enter in the terminal.
Press Ctrl + ` (Control-Tilde) to open VS Code's terminal again.

👉 Note: The default example created by Cmder might cause some verbose information messages to be displayed every time you open the Cmder terminal in VS Code, please refer to this discussion for more information. You'll need to set verbose_output to 0, and comment out any echo lines in vscode_init_args.cmd that you don't want to see, in order to mute these messages.

You may now use Cmder with VS Code.

For more support, read our guide. Here's a demo.

Spaces in the path

⚠ CAUTION: The command line interpreter in Windows has had some issues with spaces in the path, such as C:\Program Files (x86)\Cmder. We recommend installing Cmder in a path that doesn't contains spaces in order to avoid this.

If you have installed Cmder to a path with spaces, you might need to prepend a ^ symbol before each space in the path values, such that C:\\Example Directory with Spaces\\Cmder will become C:\\Example^ Directory^ with^ Spaces\\Cmder in your settings.json file.

You can also escape the parentheses ( and ) as well as spaces. Here's an example:

C:\Program Files (x86)\Cmder  →  "C:\\Program^ Files^ ^(x86^)\\Cmder"

💾 Alternatively you could use 8.3 filename convention, as a workaround:

C:\Program Files\Cmder  →  "C:\\PROGRA~1\\Cmder"

(Use PROGRA~2 for Program Files (x86))

Install VS Code in portable mode

VS Code is able to work in portable mode. To install it as portable, just follow the official instructions and configure Cmder accordingly.

Extract the VS Code zip file to %CMDER_ROOT%\bin\vscode
Create %CMDER_ROOT%\bin\vscode\data to enable portable mode.
Create the below file in %cmder_root%\bin\vscode.cmd for launching VS Code Portable from Cmder:
```
@call "%cmder_root%\bin\vscode\bin\code.cmd"
```
Start Cmder and type vscode.
Click File → Preferences, then click Edit in settings.json.

Add the below configuration to settings.json:

  "terminal.integrated.shell.windows": "cmd.exe",
  "terminal.integrated.shellArgs.windows": [
      "/K",
      "%CMDER_ROOT%/vendor/bin/vscode_init.cmd",
  ]

Use PowerShell instead of cmd.exe

Microsoft has set PowerShell as the default shell for Windows 10 and 11. To integrate Cmder with VS Code using the PowerShell profile, use the following settings. Everything else is the same as above.

    "terminal.integrated.defaultProfile.windows": "Cmder PowerShell",

    "terminal.integrated.profiles.windows": [
	"Cmder PowerShell": {
		"name": "PowerShell",
		"source": "PowerShell",
		"args": [
			"-ExecutionPolicy", "Bypass",
			"-NoLogo", "-NoProfile", "-NoExit",
			"-Command", "Invoke-Expression '. ''${env:CMDER_ROOT}\\vendor\\profile.ps1'''"
		],
		"icon": "terminal-powershell",
		"color": "terminal.ansiGreen"
	},
    ]

✅ Note the double backslashes which are required.

Of course, you can substitute ${env:cmder_root} with the absolute path of the location of your installation directory, but we instead recommend to define it.

For example, note that C:\apps\cmder\ would be the value of %CMDER_ROOT% ($env:CMDER_ROOT in PowerShell).

You can set terminal.integrated.defaultProfile.windows to be either Cmder or Cmder PowerShell, so that you'll have access to both profiles while the one you choose will be set as the default.

Automatically open VS Code at startup, as well as its built-in terminal

Related to issue #1758, make sure your Cmder has the "%cexec%" feature.

Put VS Code into %cmder_root%\bin\vsCode folder for example

(%cmder_root% is the environment variable of your Cmder installation directory, same as above.)

Use the following variables in the configuration file:

"args": ["/k", "${env:cmder_root}\\vendor\\bin\\vscode_init.bat", "/noautorun"],

Use the following commands in user-profile.cmd to run VS Code at startup:

%ccall% NOT "/noautorun" "start" "%cmder_root%\bin\vsCode\Code.exe %*"

Use Cmder Embedded Git in VS Code

Update or add the following to your user settings:

Note: Change [cmder_root] portion below with either the environment variable %cmder_root% or the absolute path to the installation folder for Cmder.

    "git.enabled": true,
    "git.path": "[cmder_root]\\vendor\\git-for-windows\\cmd\\git.exe",

if it does not work, you can try another way

    "terminal.integrated.shell.windows": "[cmder_root]\\vendor\\git-for-windows\\bin\\bash.exe",

(This will give you access to the built-in bash shell, with GNU/Linux tools such as ls, cp, mv, pwd, etc.)

👉 Note: Make sure to substitute [cmder_root] with your Cmder installation directory. You can define an environment variable to use as [cmder_root].

Optional Steps

Here's a list of unofficial extensions that you can install:

VSCodeCmder – Commands for VS Code to make it easier to use in a keyboard-only workflow

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Seamless VS Code Integration

VS Code Terminal

Spaces in the path

Install VS Code in portable mode

Use PowerShell instead of cmd.exe

Automatically open VS Code at startup, as well as its built-in terminal

Use Cmder Embedded Git in VS Code

Optional Steps

Cmder

Home

General

SSH Configuration

Setting up

Shells Integration

Terminals Integration

Editors Integration

Clone this wiki locally