ScriptRun

Visual panel to discover and run pnpm scripts defined in SCRIPTS.md.

ScriptRun adds an Activity Bar panel to VS Code that parses your project's scripts/SCRIPTS.md file and displays all available scripts organized by category. Run any script with a single click — no need to remember commands or dig through documentation.

Features

• Activity Bar Panel — Scripts appear in a dedicated sidebar view, always accessible.
• Category Organization — Scripts are grouped by ## Heading sections from your Markdown file.
• One-Click Execution — Click any script to run it instantly in an integrated terminal.
• Terminal Reuse — Re-running a script reuses its existing terminal instead of spawning a new one.
• Auto-Reload — The panel refreshes automatically when SCRIPTS.md changes.
• Refresh Button — Manually reload scripts at any time.

How It Works

ScriptRun reads a Markdown file located at scripts/SCRIPTS.md in your workspace root. The expected format is:

## Category Name

#### `pnpm your:command`

Description of what this script does.

## Another Category

#### `pnpm another:command`

Another description.

Format Rules

Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for ScriptRun
4. Click Install

From VSIX

code --install-extension scriptrun-0.1.0.vsix

Requirements

• VS Code 1.85 or higher
• A scripts/SCRIPTS.md file in your workspace root

Extension Settings

This extension has no configurable settings. It activates automatically when a scripts/SCRIPTS.md file is detected in your workspace.

Commands

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

License

MIT