Easily view and run npm scripts from package.json with a beautiful sidebar interface. Create custom scripts, build command flows, and track your usage.
✨ Features
Package.json Scripts
Beautiful Sidebar Interface - Clean, modern UI integrated into VS Code's activity bar
Smart Icon Mapping - Automatically displays appropriate icons for script types (dev, build, test, start, deploy, docker, and more)
Real-time Search - Instantly filter scripts by name or command
One-Click Execution - Run any script directly in the terminal
Auto-refresh - Automatically updates when package.json changes
Custom Scripts
Create Your Own Scripts - Add custom commands that aren't in your package.json
Workspace-Specific - Custom scripts are saved per workspace/project
Quick Access - Run your custom scripts with a single click
Flows (Multi-Command Sequences)
Command Pipelines - Chain multiple commands together like CI/CD pipelines
One-Click Execution - Run entire workflows with a single click
Cross-Platform - Works on Windows, macOS, and Linux
Usage Tracking
Usage Counter - See how many times you've run each script
Last Used Time - Know when you last ran a command
Recent Indicator - Recently used scripts are highlighted
Data Management
View Data - Inspect your saved scripts and flows as JSON
Export - Backup your custom scripts and flows to a file
Import - Restore or share configurations with replace/merge options
Tab-Specific Actions - Export/import only what you need (scripts, custom scripts, or flows)
📦 Installation
From VS Code Marketplace
Open VS Code
Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X)
Search for "Scripts Runner"
Click Install
From VSIX File
Download the .vsix file
Open VS Code
Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
Type "Install from VSIX..."
Select the downloaded .vsix file
Reload VS Code when prompted
🚀 Usage
Getting Started
Open a workspace that contains a package.json file
Click the Scripts Runner icon in the activity bar (left sidebar)
View all your npm scripts organized in a clean interface
Running Scripts
Package.json Scripts - Click any script to run npm run <script> in a new terminal
Custom Scripts - Create and run your own commands
Flows - Execute multiple commands in sequence
Navigation Tabs
Tab
Description
package.json
Scripts from your package.json file
Custom
Your custom scripts for this workspace
Flow
Multi-command workflows
Creating Custom Scripts
Switch to the Custom tab
Click to expand "Add New Script"
Enter a name and command
Click "Add Script"
Creating Flows
Switch to the Flow tab
Click to expand "Add New Flow"
Enter a flow name
Add multiple commands using "Add command" button
Click "Create Flow"
Import/Export
Global Actions (top) - View All, Export All, Import All data
Tab Actions (bottom of each tab) - Work with specific data types only
