Package Script Bar

A VS Code extension that displays a streamlined toolbar at the bottom left of the editor with clickable buttons for your root package.json scripts. Run scripts with one click—in the background or in terminal. Customize button colors. Nickname scripts to make them clean. With automatic package manager detection.

Author: bryanthaboi

Features

• Script Bar Panel: A compact toolbar in the bottom left panel with buttons for each enabled script
• Enable/Disable Scripts: Choose which scripts appear in the bar via the config file
• Nicknames: Give scripts short labels (e.g., build:prod → Build Prod) for cleaner buttons
• Custom Colors: Set a color for each script button
• Run Modes:
  • Background (default): Runs silently, shows a notification when complete
  • Terminal: Opens a visible terminal and runs the script
• Rescan: Detects new scripts in package.json without overwriting your existing enable/disable, nicknames, or colors
• Team Config: Uses .vscode/package-script-bar.json so teams can share script preferences via Git

Requirements

• VS Code ^1.80.0
• A workspace folder with a root package.json containing a scripts section

Quick Start

1. Open a folder that has a package.json with scripts
2. Open the Script Bar panel (bottom panel, look for the Script Bar tab with the run icon)
3. Click any script button to run it

Configuration

VS Code Settings

Workspace Config (.vscode/package-script-bar.json)

This file is created automatically when you use the extension. Edit it to customize scripts. Use Open Script Bar Config from the Command Palette or the panel title bar.

Config schema:

{
	"scripts": {
		"build": {
			"enabled": true,
			"nickname": "Build",
			"color": "#4CAF50",
			"runMode": "background"
		},
		"test": {
			"enabled": false,
			"nickname": "Test",
			"color": "#2196F3",
			"runMode": "terminal"
		}
	}
}

Rescan package.json

Use Rescan package.json (refresh icon in the panel title bar or Command Palette) when you:

• Add new scripts to package.json
• Remove scripts (config for removed scripts is cleaned up)
• Want to pick up changes without losing your existing preferences

Rescan merges with your config: new scripts get defaults, existing scripts keep your settings, and removed scripts are dropped.

Team Sharing

Commit .vscode/package-script-bar.json to your repo so everyone gets the same script bar setup. New scripts from package.json will appear for everyone; each teammate can run Rescan if they add scripts locally.

Commands

Release Notes

1.0.2

Automatic package manager detection. Screenshot in the readme. We the best. DJ Khaled.

0.0.1

Initial release of Package Script Bar.