Swish Core

This is a command line tool which provides the power of Swish to your terminal.

Installation

npm install -g @swish/core

You can also run Swish without installing it by using npx:

npx @swishjs/core --help

Usage

You can get details on how to use Swish by running swish --help.

List available plugins

swish --list

Run a plugin

You can do one of the following to pass some data from a file:

• cat file.txt | swish plugin-id (Pipe the file contents in from Cat)
• swish plugin-id < file.txt (Redirect the file contents in from the file)
• swish plugin-id --file file.txt (Have Swish read the file)

Where file.txtis the file you want to process and plugin-id is the id of the plugin you want to run.

If you don't want to pass any input (some plugins like uuid-generate don't need input), you need to pass a -0 or --noinput flag so Swish knows not to wait for input on stdin.

Something isn't working!

Firstly, run with the -v flag to get verbose output. This will print out useful logs including:

• If a plugin isn't available, why it wasn't loaded - this could be because:
  • It's broken and failed to load
  • It took too long to load (more than 200ms) and was skipped
  • It requires something Swish Core doesn't provide
  • Swish is looking in the wrong place for it
• If the plugin did something bad and was terminated