History

npm CLI robot d568a1bb53 deps: upgrade npm to 10.9.8 PR-URL: https://github.com/nodejs/node/pull/62463 Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Jordan Harband <ljharb@gmail.com> Reviewed-By: Santiago Gimeno <santiago.gimeno@gmail.com> Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com> Reviewed-By: Richard Lau <richard.lau@ibm.com>		2026-05-11 14:47:50 +02:00
..
lib	deps: upgrade npm to 10.8.3	2024-09-12 11:06:48 +02:00
LICENSE
package.json	deps: upgrade npm to 10.9.8	2026-05-11 14:47:50 +02:00
README.md	deps: upgrade npm to 10.7.0	2024-05-01 10:53:25 +02:00

README.md

libnpmexec

The npm exec (npx) Programmatic API

Install

npm install libnpmexec

Usage:

const libexec = require('libnpmexec')
await libexec({
  args: ['yosay', 'Bom dia!'],
  cache: '~/.npm/_cacache',
  npxCache: '~/.npm/_npx',
  yes: true,
})

API:

`libexec(opts)`

opts:
- args: List of pkgs to execute Array, defaults to []
- call: An alternative command to run when using packages option String, defaults to empty string.
- cache: The path location to where the npm cache folder is placed String
- npxCache: The path location to where the npx cache folder is placed String
- chalk: Chalk instance to use for colors? Required
- localBin: Location to the node_modules/.bin folder of the local project to start scanning for bin files String, defaults to ./node_modules/.bin. libexec will walk up the directory structure looking for node_modules/.bin folders in parent folders that might satisfy the current arg and will use that bin if found.
- locationMsg: Overrides "at location" message when entering interactive mode String
- globalBin: Location to the global space bin folder, same as: $(npm bin -g) String, defaults to empty string.
- packages: A list of packages to be used (possibly fetch from the registry) Array, defaults to []
- path: Location to where to read local project info (package.json) String, defaults to .
- runPath: Location to where to execute the script String, defaults to .
- scriptShell: Default shell to be used String, defaults to sh on POSIX systems, process.env.ComSpec OR cmd on Windows
- yes: Should skip download confirmation prompt when fetching missing packages from the registry? Boolean
- registry, cache, and more options that are forwarded to @npmcli/arborist and pacote Object

LICENSE

ISC