markdownDescription:nls.localize('terminal.integrated.shellArgs.linux',"The command line arguments to use when on the Linux terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
type:'array',
items:{
type:'string'
},
default:[]
},
'terminal.integrated.shellArgs.osx':{
markdownDescription:nls.localize('terminal.integrated.shellArgs.osx',"The command line arguments to use when on the macOS terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
type:'array',
items:{
type:'string'
},
// Unlike on Linux, ~/.profile is not sourced when logging into a macOS session. This
// is the reason terminals on macOS typically run login shells by default which set up
// the environment. See http://unix.stackexchange.com/a/119675/115410
default:['-l']
},
'terminal.integrated.shellArgs.windows':{
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows',"The command line arguments to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
'anyOf':[
{
type:'array',
items:{
type:'string',
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows',"The command line arguments to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration).")
},
},
{
type:'string',
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows.string',"The command line arguments in [command-line format](https://msdn.microsoft.com/en-au/08dfcab2-eb6e-49a4-80eb-87d4076c98c6) to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration).")
}
],
default:[]
},
'terminal.integrated.macOptionIsMeta':{
description:nls.localize('terminal.integrated.macOptionIsMeta',"Controls whether to treat the option key as the meta key in the terminal on macOS."),
description:nls.localize('terminal.integrated.macOptionClickForcesSelection',"Controls whether to force selection when using Option+click on macOS. This will force a regular (line) selection and disallow the use of column selection mode. This enables copying and pasting using the regular terminal selection, for example, when mouse mode is enabled in tmux."),
type:'boolean',
default:false
},
'terminal.integrated.copyOnSelection':{
description:nls.localize('terminal.integrated.copyOnSelection',"Controls whether text selected in the terminal will be copied to the clipboard."),
description:nls.localize('terminal.integrated.drawBoldTextInBrightColors',"Controls whether bold text in the terminal will always use the \"bright\" ANSI color variant."),
type:'boolean',
default:true
},
'terminal.integrated.fontFamily':{
markdownDescription:nls.localize('terminal.integrated.fontFamily',"Controls the font family of the terminal, this defaults to `#editor.fontFamily#`'s value."),
type:'string'
},
// TODO: Support font ligatures
// 'terminal.integrated.fontLigatures': {
// 'description': nls.localize('terminal.integrated.fontLigatures', "Controls whether font ligatures are enabled in the terminal."),
// 'type': 'boolean',
// 'default': false
// },
'terminal.integrated.fontSize':{
description:nls.localize('terminal.integrated.fontSize',"Controls the font size in pixels of the terminal."),
type:'number',
default:EDITOR_FONT_DEFAULTS.fontSize
},
'terminal.integrated.letterSpacing':{
description:nls.localize('terminal.integrated.letterSpacing',"Controls the letter spacing of the terminal, this is an integer value which represents the amount of additional pixels to add between characters."),
type:'number',
default:DEFAULT_LETTER_SPACING
},
'terminal.integrated.lineHeight':{
description:nls.localize('terminal.integrated.lineHeight',"Controls the line height of the terminal, this number is multiplied by the terminal font size to get the actual line-height in pixels."),
description:nls.localize('terminal.integrated.rightClickBehavior',"Controls how terminal reacts to right click.")
},
'terminal.integrated.cwd':{
description:nls.localize('terminal.integrated.cwd',"An explicit start path where the terminal will be launched, this is used as the current working directory (cwd) for the shell process. This may be particularly useful in workspace settings if the root directory is not a convenient cwd."),
type:'string',
default:undefined
},
'terminal.integrated.confirmOnExit':{
description:nls.localize('terminal.integrated.confirmOnExit',"Controls whether to confirm on exit if there are active terminal sessions."),
type:'boolean',
default:false
},
'terminal.integrated.enableBell':{
description:nls.localize('terminal.integrated.enableBell',"Controls whether the terminal bell is enabled."),
type:'boolean',
default:false
},
'terminal.integrated.commandsToSkipShell':{
description:nls.localize('terminal.integrated.commandsToSkipShell',"A set of command IDs whose keybindings will not be sent to the shell and instead always be handled by Code. This allows the use of keybindings that would normally be consumed by the shell to act the same as when the terminal is not focused, for example ctrl+p to launch Quick Open.\nDefault Skipped Commands:\n\n{0}",DEFAULT_COMMANDS_TO_SKIP_SHELL.sort().map(command=>`- ${command}`).join('\n')),
type:'array',
items:{
type:'string'
},
default:[]
},
'terminal.integrated.env.osx':{
markdownDescription:nls.localize('terminal.integrated.env.osx',"Object with environment variables that will be added to the VS Code process to be used by the terminal on macOS. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.env.linux':{
markdownDescription:nls.localize('terminal.integrated.env.linux',"Object with environment variables that will be added to the VS Code process to be used by the terminal on Linux. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.env.windows':{
markdownDescription:nls.localize('terminal.integrated.env.windows',"Object with environment variables that will be added to the VS Code process to be used by the terminal on Windows. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.showExitAlert':{
description:nls.localize('terminal.integrated.showExitAlert',"Controls whether to show the alert \"The terminal process terminated with exit code\" when exit code is non-zero."),
type:'boolean',
default:true
},
'terminal.integrated.splitCwd':{
description:nls.localize('terminal.integrated.splitCwd',"Controls the working directory a split terminal starts with."),
type:'string',
enum:['workspaceRoot','initial','inherited'],
enumDescriptions:[
nls.localize('terminal.integrated.splitCwd.workspaceRoot',"A new split terminal will use the workspace root as the working directory. In a multi-root workspace a choice for which root folder to use is offered."),
nls.localize('terminal.integrated.splitCwd.initial',"A new split terminal will use the working directory that the parent terminal started with."),
nls.localize('terminal.integrated.splitCwd.inherited',"On macOS and Linux, a new split terminal will use the working directory of the parent terminal. On Windows, this behaves the same as initial."),
],
default:'inherited'
},
'terminal.integrated.windowsEnableConpty':{
description:nls.localize('terminal.integrated.windowsEnableConpty',"Whether to use ConPTY for Windows terminal process communication (requires Windows 10 build number 18309+). Winpty will be used if this is false."),
registry.registerWorkbenchAction(newSyncActionDescriptor(QuickOpenTermAction,QuickOpenTermAction.ID,QuickOpenTermAction.LABEL),'Terminal: Switch Active Terminal',nls.localize('terminal',"Terminal"));
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(KillTerminalAction,KillTerminalAction.ID,KillTerminalAction.LABEL),'Terminal: Kill the Active Terminal Instance',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(CreateNewInActiveWorkspaceTerminalAction,CreateNewInActiveWorkspaceTerminalAction.ID,CreateNewInActiveWorkspaceTerminalAction.LABEL),'Terminal: Create New Integrated Terminal (In Active Workspace)',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(FocusNextTerminalAction,FocusNextTerminalAction.ID,FocusNextTerminalAction.LABEL),'Terminal: Focus Next Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(RunSelectedTextInTerminalAction,RunSelectedTextInTerminalAction.ID,RunSelectedTextInTerminalAction.LABEL),'Terminal: Run Selected Text In Active Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(RunActiveFileInTerminalAction,RunActiveFileInTerminalAction.ID,RunActiveFileInTerminalAction.LABEL),'Terminal: Run Active File In Active Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SplitInActiveWorkspaceTerminalAction,SplitInActiveWorkspaceTerminalAction.ID,SplitInActiveWorkspaceTerminalAction.LABEL),'Terminal: Split Terminal (In Active Workspace)',category);
},KEYBINDING_CONTEXT_TERMINAL_FOCUS),'Terminal: Select To Next Command',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SelectToPreviousLineAction,SelectToPreviousLineAction.ID,SelectToPreviousLineAction.LABEL),'Terminal: Select To Previous Line',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SelectToNextLineAction,SelectToNextLineAction.ID,SelectToNextLineAction.LABEL),'Terminal: Select To Next Line',category);
registry.registerWorkbenchAction(newSyncActionDescriptor(QuickOpenTermAction,QuickOpenTermAction.ID,QuickOpenTermAction.LABEL),'Terminal: Switch Active Terminal',nls.localize('terminal',"Terminal"));
markdownDescription:nls.localize('terminal.integrated.shellArgs.linux',"The command line arguments to use when on the Linux terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
type:'array',
items:{
type:'string'
},
default:[]
},
'terminal.integrated.shell.osx':{
markdownDescription:nls.localize('terminal.integrated.shell.osx',"The path of the shell that the terminal uses on macOS. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
type:'string',
default:getDefaultShell(platform.Platform.Mac)
},
'terminal.integrated.shellArgs.osx':{
markdownDescription:nls.localize('terminal.integrated.shellArgs.osx',"The command line arguments to use when on the macOS terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
type:'array',
items:{
type:'string'
},
// Unlike on Linux, ~/.profile is not sourced when logging into a macOS session. This
// is the reason terminals on macOS typically run login shells by default which set up
// the environment. See http://unix.stackexchange.com/a/119675/115410
default:['-l']
},
'terminal.integrated.shell.windows':{
markdownDescription:nls.localize('terminal.integrated.shell.windows',"The path of the shell that the terminal uses on Windows. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows',"The command line arguments to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration)."),
'anyOf':[
{
type:'array',
items:{
type:'string',
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows',"The command line arguments to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration).")
},
},
{
type:'string',
markdownDescription:nls.localize('terminal.integrated.shellArgs.windows.string',"The command line arguments in [command-line format](https://msdn.microsoft.com/en-au/08dfcab2-eb6e-49a4-80eb-87d4076c98c6) to use when on the Windows terminal. [Read more about configuring the shell](https://code.visualstudio.com/docs/editor/integrated-terminal#_configuration).")
}
],
default:[]
},
'terminal.integrated.macOptionIsMeta':{
description:nls.localize('terminal.integrated.macOptionIsMeta',"Controls whether to treat the option key as the meta key in the terminal on macOS."),
description:nls.localize('terminal.integrated.macOptionClickForcesSelection',"Controls whether to force selection when using Option+click on macOS. This will force a regular (line) selection and disallow the use of column selection mode. This enables copying and pasting using the regular terminal selection, for example, when mouse mode is enabled in tmux."),
type:'boolean',
default:false
},
'terminal.integrated.copyOnSelection':{
description:nls.localize('terminal.integrated.copyOnSelection',"Controls whether text selected in the terminal will be copied to the clipboard."),
description:nls.localize('terminal.integrated.drawBoldTextInBrightColors',"Controls whether bold text in the terminal will always use the \"bright\" ANSI color variant."),
type:'boolean',
default:true
},
'terminal.integrated.fontFamily':{
markdownDescription:nls.localize('terminal.integrated.fontFamily',"Controls the font family of the terminal, this defaults to `#editor.fontFamily#`'s value."),
type:'string'
},
// TODO: Support font ligatures
// 'terminal.integrated.fontLigatures': {
// 'description': nls.localize('terminal.integrated.fontLigatures', "Controls whether font ligatures are enabled in the terminal."),
// 'type': 'boolean',
// 'default': false
// },
'terminal.integrated.fontSize':{
description:nls.localize('terminal.integrated.fontSize',"Controls the font size in pixels of the terminal."),
type:'number',
default:EDITOR_FONT_DEFAULTS.fontSize
},
'terminal.integrated.letterSpacing':{
description:nls.localize('terminal.integrated.letterSpacing',"Controls the letter spacing of the terminal, this is an integer value which represents the amount of additional pixels to add between characters."),
type:'number',
default:DEFAULT_LETTER_SPACING
},
'terminal.integrated.lineHeight':{
description:nls.localize('terminal.integrated.lineHeight',"Controls the line height of the terminal, this number is multiplied by the terminal font size to get the actual line-height in pixels."),
description:nls.localize('terminal.integrated.rightClickBehavior',"Controls how terminal reacts to right click.")
},
'terminal.integrated.cwd':{
description:nls.localize('terminal.integrated.cwd',"An explicit start path where the terminal will be launched, this is used as the current working directory (cwd) for the shell process. This may be particularly useful in workspace settings if the root directory is not a convenient cwd."),
type:'string',
default:undefined
},
'terminal.integrated.confirmOnExit':{
description:nls.localize('terminal.integrated.confirmOnExit',"Controls whether to confirm on exit if there are active terminal sessions."),
type:'boolean',
default:false
},
'terminal.integrated.enableBell':{
description:nls.localize('terminal.integrated.enableBell',"Controls whether the terminal bell is enabled."),
type:'boolean',
default:false
},
'terminal.integrated.commandsToSkipShell':{
description:nls.localize('terminal.integrated.commandsToSkipShell',"A set of command IDs whose keybindings will not be sent to the shell and instead always be handled by Code. This allows the use of keybindings that would normally be consumed by the shell to act the same as when the terminal is not focused, for example ctrl+p to launch Quick Open.\nDefault Skipped Commands:\n\n{0}",DEFAULT_COMMANDS_TO_SKIP_SHELL.sort().map(command=>`- ${command}`).join('\n')),
type:'array',
items:{
type:'string'
},
default:[]
},
'terminal.integrated.env.osx':{
markdownDescription:nls.localize('terminal.integrated.env.osx',"Object with environment variables that will be added to the VS Code process to be used by the terminal on macOS. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.env.linux':{
markdownDescription:nls.localize('terminal.integrated.env.linux',"Object with environment variables that will be added to the VS Code process to be used by the terminal on Linux. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.env.windows':{
markdownDescription:nls.localize('terminal.integrated.env.windows',"Object with environment variables that will be added to the VS Code process to be used by the terminal on Windows. Set to `null` to delete the environment variable."),
type:'object',
additionalProperties:{
type:['string','null']
},
default:{}
},
'terminal.integrated.showExitAlert':{
description:nls.localize('terminal.integrated.showExitAlert',"Controls whether to show the alert \"The terminal process terminated with exit code\" when exit code is non-zero."),
type:'boolean',
default:true
},
'terminal.integrated.splitCwd':{
description:nls.localize('terminal.integrated.splitCwd',"Controls the working directory a split terminal starts with."),
type:'string',
enum:['workspaceRoot','initial','inherited'],
enumDescriptions:[
nls.localize('terminal.integrated.splitCwd.workspaceRoot',"A new split terminal will use the workspace root as the working directory. In a multi-root workspace a choice for which root folder to use is offered."),
nls.localize('terminal.integrated.splitCwd.initial',"A new split terminal will use the working directory that the parent terminal started with."),
nls.localize('terminal.integrated.splitCwd.inherited',"On macOS and Linux, a new split terminal will use the working directory of the parent terminal. On Windows, this behaves the same as initial."),
],
default:'inherited'
},
'terminal.integrated.windowsEnableConpty':{
description:nls.localize('terminal.integrated.windowsEnableConpty',"Whether to use ConPTY for Windows terminal process communication (requires Windows 10 build number 18309+). Winpty will be used if this is false."),
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(KillTerminalAction,KillTerminalAction.ID,KillTerminalAction.LABEL),'Terminal: Kill the Active Terminal Instance',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(CreateNewInActiveWorkspaceTerminalAction,CreateNewInActiveWorkspaceTerminalAction.ID,CreateNewInActiveWorkspaceTerminalAction.LABEL),'Terminal: Create New Integrated Terminal (In Active Workspace)',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(FocusNextTerminalAction,FocusNextTerminalAction.ID,FocusNextTerminalAction.LABEL),'Terminal: Focus Next Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(RunSelectedTextInTerminalAction,RunSelectedTextInTerminalAction.ID,RunSelectedTextInTerminalAction.LABEL),'Terminal: Run Selected Text In Active Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(RunActiveFileInTerminalAction,RunActiveFileInTerminalAction.ID,RunActiveFileInTerminalAction.LABEL),'Terminal: Run Active File In Active Terminal',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SplitInActiveWorkspaceTerminalAction,SplitInActiveWorkspaceTerminalAction.ID,SplitInActiveWorkspaceTerminalAction.LABEL),'Terminal: Split Terminal (In Active Workspace)',category);
},KEYBINDING_CONTEXT_TERMINAL_FOCUS),'Terminal: Select To Next Command',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SelectToPreviousLineAction,SelectToPreviousLineAction.ID,SelectToPreviousLineAction.LABEL),'Terminal: Select To Previous Line',category);
actionRegistry.registerWorkbenchAction(newSyncActionDescriptor(SelectToNextLineAction,SelectToNextLineAction.ID,SelectToNextLineAction.LABEL),'Terminal: Select To Next Line',category);