XCommand Tasks

XCommand Tasks adds clickable status bar buttons for commands you define in .vscode/xcmd.json.

Each task becomes a button. Clicking it runs the configured commands in a terminal.

Features

• Creates status bar buttons from .vscode/xcmd.json.
• Supports custom icons per task.
• Runs multiple chained commands per task.
• Named terminals with custom shell paths (including MSYS2/MinGW).
• Falls back to the active terminal when no terminal is specified.
• Auto-refreshes when xcmd.json is saved.

Quick Start

1. Open a workspace in VS Code.
2. Create .vscode/xcmd.json in the workspace root.
3. Add tasks and optional terminal definitions.

Example:

{
	"tasks": {
		"Build": {
			"icon": "$(tools)",
			"commands": ["npm run build"]
		},
		"Test": {
			"icon": "$(beaker)",
			"commands": ["npm test"]
		},
		"Deploy": {
			"icon": "$(rocket)",
			"commands": ["npm run build", "npm run deploy"],
			"terminal": "bash"
		}
	},
	"terminals": [
		{
			"name": "bash",
			"path": "C:\\msys64\\msys2_shell.cmd"
		}
	]
}

Task Fields

Each key under tasks is the button label.

Icon Examples

Common Icons

Terminal Fields

Each entry in terminals defines a named shell.

Notes

• Config is loaded from the first workspace folder.
• If .vscode/xcmd.json is missing or invalid, no buttons are shown.
• Named terminals are created on first use and reused for subsequent commands.

Release Notes

1.0.0

Initial release.