@rodbe/nsl

NSL ⚡️ - Node Script List

List, fuzzy search and run scripts from any type of project

Easy and fast way to run npm scripts 🚀

Prerequisites

• Node.js 18.18.2 or higher

📦 Install

npm i -g @rodbe/nsl

if you have a permission error, try to install with administrator privileges

🏎️ Usage

🌟 Just run the command and search for the script you want to run.

nsl

🧙‍♂️ Ways to search

Select or search a script to run: <script> [project-path]

• <script>: Text to match the script name (required)
• [project-path]: Text to filter by the folder where the script lives (optional)

🎖️ Examples (Pro Tips)

• Search for a script named build throughout the entire project:

Select or search a script to run: build

• Look for a script called build inside folders containing api:

Select or search a script to run: build api

🌟 To run the latest executed script of the current project

nn

🧩 Arguments

⚙️ Configuration file

You can configure NSL via (in order of precedence):

• A .nslrc file written in JSON
• A .nslrc.json file
• A .nslrc.js file written in ES module that exports an object using export default
• A .nslrc.cjs file written in CommonJS module that exports an object using module.exports

Options

The options you can use in the configuration file.

✨ Basic configuration

JSON: .nslrc o .nslrc.json file

{
  "ignoreScripts": [
    "any-script-name-to-ignore",
    "other-script-name-to-ignore",
    "another-script-name-to-ignore"
  ]
}

JS (ES Modules): .nslrc.js file

export default {
  ignoreScripts: [
    'any-script-name-to-ignore',
    'other-script-name-to-ignore',
    'another-script-name-to-ignore',
  ],
};

CJS (CommonJS): .nslrc.cjs file

module.exports = {
  ignoreScripts: [
    'any-script-name-to-ignore',
    'other-script-name-to-ignore',
    'another-script-name-to-ignore',
  ],
};

👋 Contributors are welcome

License

MIT