pm run

Overview

The pm run command executes scripts defined in your package.json file. It’s a simple passthrough to your package manager’s run command.

Syntax

pm run <script> [...args]

Arguments

string

required

The name of the script to run from package.json

string[]

Additional arguments to pass to the script

Examples

Run Build Script

pm run build

Output

Running: pnpm run build

Run Test Script

pm run test

Output

Running: pnpm run test

Run Script with Arguments

pm run test -- --watch

Output

Running: pnpm run test -- --watch

Run Custom Script

pm run dev

Output

Running: pnpm run dev

Package.json Scripts

Define scripts in your package.json:

package.json

{
  "scripts": {
    "dev": "vite",
    "build": "tsc && vite build",
    "test": "vitest",
    "lint": "eslint ."
  }
}

Then run them with:

pm run dev
pm run build
pm run test
pm run lint

How It Works

From src/commands/run.ts:14:

const cmd = ShellCommand.make(pm.name, 'run', ...passthrough);
yield* Console.log(`Running: ${pm.name} run ${passthrough.join(' ')}`);
yield* runShellCommand(cmd);

The command:

Detects your project’s package manager
Passes all arguments directly to <pm> run
Executes the command with the script and any additional arguments

Package Manager Compatibility

Package Manager	Command
pnpm	`pnpm run <script>`
bun	`bun run <script>`
npm	`npm run <script>`

All package managers support the run command, making this a universal way to execute scripts.

Common Scripts

Typical scripts you might run:

dev - Start development server
build - Build for production
test - Run tests
lint - Run linter
format - Format code
typecheck - Run TypeScript type checking
preview - Preview production build

pm x - Execute packages without installing
pm install - Install dependencies

Get Started

Core Concepts

Commands

Guides

Overview

Syntax

Arguments

Examples

Run Build Script

Run Test Script

Run Script with Arguments

Run Custom Script

Package.json Scripts

How It Works

Package Manager Compatibility

Common Scripts

​Overview

​Syntax

​Arguments

​Examples

​Run Build Script

​Run Test Script

​Run Script with Arguments

​Run Custom Script

​Package.json Scripts

​How It Works

​Package Manager Compatibility

​Common Scripts

​Related Commands

Overview

Syntax

Arguments

Examples

Run Build Script

Run Test Script

Run Script with Arguments

Run Custom Script

Package.json Scripts

How It Works

Package Manager Compatibility

Common Scripts

Related Commands