mysticatea/npm-run-all
Npm Run All
npm-run-all is a command-line and programmatic tool for running multiple npm scripts in sequence, parallel, or mixed combinations without requiring an external task runner. It provides a straightforward way to orchestrate complex multi-step build or test workflows directly from the terminal or from within Node.js application code.
The tool distinguishes itself by supporting mixed execution plans that combine sequential and parallel steps into a single command, allowing users to define dependency graphs where some scripts run concurrently while others wait for completion. It manages child-process lifecycles, pools concurrent processes, chains sequential promises, and aggregates exit codes from all child processes into a single final result. When Yarn originally invoked the tool, it automatically proxies script execution through Yarn instead of npm.
Beyond the CLI, npm-run-all offers a programmatic API for orchestrating scripts from application code, enabling dynamic workflow management. The documentation covers installation, CLI usage, and the programmatic interface for integrating script orchestration into larger automation pipelines.
Features
- NPM Script Runners - Runs multiple npm scripts in sequence or parallel from a single command to simplify build and test workflows.
- Mixed Sequential-Parallel Plans - Combines sequential and parallel execution steps into a single command for complex script workflows.
- Concurrent Script Executors - Starts multiple npm scripts concurrently and runs them all at the same time.
- Sequential Script Executors - Executes a list of npm scripts one after another, waiting for each to finish before starting the next.
- Dependency Graph Runners - Builds a directed acyclic graph from combined sequential and parallel steps to determine execution order.
- Sequential Task Execution - Executes npm scripts one after another, waiting for each to finish before starting the next.
- Mixed Execution Orchestrators - Combines sequential and parallel execution steps into a single command for complex script workflows.
- Multi-Stage Workflow Automations - Combines sequential and parallel script steps into one command to orchestrate complex multi-step build or test processes.
- Concurrent Script Launchers - Starts several npm scripts at once and runs them concurrently to speed up tasks like linting and testing.
- Promise-Based Chains - Chains promises that resolve when each child process completes, executing scripts one after another.
- Child Process Execution - Spawns and manages child processes to execute npm scripts, coordinating their lifecycle events.
- Process Pools - Maintains a pool of child processes to run concurrent scripts and aggregate their exit codes.
- Aggregated Exit Code Collectors - Aggregates exit codes from all child processes into a single final exit code for the orchestrator.
- Programmatic Orchestration APIs - Provides a Node.js API to orchestrate npm scripts in sequence or parallel from application code.
- Script Orchestration APIs - Orchestrates npm scripts from within Node.js application code using an API for dynamic workflow management.
- NPM Script Orchestration APIs - Orchestrates npm scripts in sequence or parallel from within application code using a Node.js API.
- Package Management - Runs multiple npm scripts.
- Task Automation - Runs multiple scripts in parallel or serial.
- Task Runners - Fully featured task runner.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
