README.md

VSCode Command Runner

Run custom shell command defined in vs code configuration and node module package.json

Features

• Run custom shell command
• Run selected content as shell command
• Run custom shell command with selected files by explorer context menu

Extension Settings

You can defined shell command in vs code configuration

{
    "command-runner.terminal.name": "runCommand",
    "command-runner.terminal.autoClear": true,
    "command-runner.terminal.autoFocus": true,
    "command-runner.commands": {
        "echo workspaceFolder": "echo ${workspaceFolder}",
        "echo file": "echo ${file}"
    }
}

or in node module package.json

{
    "commands": {
        "echo workspaceFolder": "echo ${workspaceFolder}",
        "echo file": "echo ${file}"
    }
}

Multiple commands can be executed sequentially with Here is an example of formatting golang code

{
    "command-runner2.commands": {
        "go.format": [
            "IFS=;text=$(cat <<EOFL\n${selectedText}\n\nEOFL\n); echo $text | gofmt | iconv -f UTF-8 -t GBK | clip",
            "${command:workbench.action.focusActiveEditorGroup}",
            "${command:editor.action.clipboardPasteAction}",
        ],
    }
}

Call a link remotely, and a pop-up window displays the result of the request

{
 "command-runner2.commands": {
    "cht.sh": [
        "${command:workbench.action.newGroupRight}${command:workbench.action.files.newUntitledFile}IFS=;text=$(curl -s cht.sh/${input}?style=bw); echo $text | clip",
        "${command:editor.action.clipboardPasteAction}"
    ],
    "curls": [
        "${command:workbench.action.newGroupRight}${command:workbench.action.files.newUntitledFile}IFS=;text=$(curl -s ${input}); echo $text | clip",
        "${command:editor.action.clipboardPasteAction}"
    ],
    "demo": "echo helloworld",
 }
}

Key Binding

You can bind custom keys for the command which defined in configuration

{
    "key": "ctrl+alt+1",
    "command": "command-runner.run",
    "args": { "command": "echo file" }
}

Terminal Options

You can customize the terminal for the command

{
    "key": "ctrl+alt+1",
    "command": "command-runner.run",
    "args": {
        "command": "echo file",
        "terminal": "runCommand"
    }
}

or

{
    "key": "ctrl+alt+1",
    "command": "command-runner.run",
    "args": {
        "terminal": {
            "name": "runCommand",
            "cwd": "path/to/runCommand",
            "shellArgs": [],
            "autoClear": true,
            "autoFocus": true
        }
    }
}

vim keybinding

    "vim.visualModeKeyBindingsNonRecursive": [
        {
            "before": [
                "g","f"
            ],
            "commands": [
                {
                    "command": "command-runner2.run",
                    "args": {
                        "command": "go.format"
                    }
                }
            ]
        },

Predefined Variable

• ${file}: activated file path;
• ${fileBasename}: activated file basename;
• ${fileBasenameNoExtension}: activated file basename with no extension;
• ${fileDirname}: activated file dirname;
• ${fileExtname}: activated file extension;
• ${lineNumber}: the first selected line number;
• ${lineNumbers}: the all selected line number, eg. 41,46,80;
• ${columnNumber}: the first selected column number;
• ${columnNumbers}: the all selected column number, eg. 41,46,80;
• ${selectedFile}: the first selected file/folder from the context menu`;
• ${selectedFiles}: the selected file/folder list from the context menu or use config, eg. "path/to/file1" "path/to/file2";
• ${selectedText}: the first selected text;
• ${selectedTextList}: the all selected text list, eg. sl1 sl2;
• ${selectedTextSection}: the all selected text section, eg. sl1\nsl2;
• ${selectedPosition}: the selected position list, eg. 21,6;
• ${selectedPositionList}: the all selected position list, eg. 45,6 80,18 82,5;
• ${selectedLocation}: the first selected location, eg. 21,6,21,10;
• ${selectedLocationList}: the all selected location list, eg. 21,6,21,10 22,6,22,10 23,6,23,10;
• ${relativeFile}: activated file relative path;
• ${workspaceFolder}: activated workspace folder path;
• ${workspaceFolderBasename}: activated workspace folder basename;
• ${homedir}: the home directory of the current user;
• ${tmpdir}: default directory for temporary files;
• ${platform}: os platform;
• ${env:PATH}: shell environment variable "PATH";
• ${config:editor.fontSize}: vscode config variable;
• ${command:workbench.action.terminal.clear}: run vscode command;
• ${input}: input a value as parameter;
• ${input:defaultValue}: input a value as parameter, and specify the default value;

Usages

• use shortcut Ctrl+Shift+R to select custom command
• use shortcut Ctrl+Alt+R to run selected content as shell command
• or press F1 and then select/type Run Command or Run In Terminal,
• or right click the Text Editor and then click Run Command to select custom command in editor context menu
• or right click the Text Editor and then click Run In Terminal to run selected content as shell command in editor context menu