Scripts Launcher
A Visual Studio Code extension that provides a convenient status bar button with dropdown menu for executing npm scripts from your package.json file.
Features
- Status Bar Integration: Quick access via a "Run Task" button in the status bar
- Script Selection: Choose which scripts to display in the dropdown menu
- One-Click Execution: Run npm scripts with a single click
- Terminal Integration: Scripts execute in VSCode's integrated terminal
- Workspace Configuration: Different script selections per project
Installation
From VSCode Marketplace
- Open VSCode
- Go to Extensions (Ctrl+Shift+X)
- Search for "Scripts Launcher"
- Click Install
From VSIX Package
- Download the .vsix file from releases
- Open VSCode
- Go to Extensions (Ctrl+Shift+X)
- Click the "..." menu and select "Install from VSIX..."
- Select the downloaded .vsix file
Usage
Initial Setup
- Open a project that contains a
package.json file with scripts
- Look for the "Run Task" button in the status bar (bottom of VSCode)
- Click the button to open the dropdown menu
- Select "Select Tasks" to choose which scripts to display
Running Scripts
- Click the "Run Task" button in the status bar
- Choose a script from the dropdown menu
- The script will execute in a new terminal tab
Managing Selected Scripts
- Click "Run Task" → "Selected Tasks" (or "Select Tasks" if none selected)
- Check/uncheck scripts you want to show in the dropdown
- Click OK to save your selection
Configuration
The extension stores your script selections in the workspace configuration. You can also manually edit the settings:
{
"scriptsLauncher.selectedScripts": [
"build",
"test",
"start"
]
}
Requirements
- Visual Studio Code 1.74.0 or higher
- A project with a
package.json file containing scripts
- Node.js and npm installed (for script execution)
Extension Settings
This extension contributes the following settings:
scriptsLauncher.selectedScripts: Array of script names to show in the dropdown menu
Known Issues
- Scripts must be defined in the root
package.json file
- Only npm scripts are currently supported (yarn/pnpm support planned)
Release Notes
1.0.0
Initial release of Scripts Launcher
- Status bar button with dropdown menu
- Script selection interface
- Terminal integration for script execution
- Workspace-level configuration
Contributing
Contributions are welcome! Please see the development guide for setup instructions.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
If you encounter any issues or have feature requests, please:
- Check the known issues section
- Search existing GitHub issues
- Create a new issue if needed
Changelog
See CHANGELOG.md for a detailed history of changes.
