doowb / watch-cli

Watch files and execute an npm script when files change.

watch-cli

Command line wrapper for gaze to use in package.json scripts object.

Install globally

Install globally with npm

npm i -g watch-cli

Usage

watch -p "**/*.js" -c "npm test"

Options

Short	Long	Type	Description
-p	--pattern	string	glob pattern you are want to watch.
-c	--command	string	Command to execute on watched files change.

Multi Patterns

It is possible to provide multi paterns, so if one of the files changed, the command will execute.

watch -p file1.js -p file2.fs -c command

Exported environment variables

Environment variables available from the command string:

FILENAME           Relative filename.
ABSOLUTE_FILENAME  Asolute filename.
EVENT              Event type. Is either 'changed', 'deleted' or 'added'.

Use it like this in Linux/macOS:

$ watch -p '**/*.js' -c 'jshint $FILENAME'

In Windows:

> watch -p "**/*.js" -c "jshint %FILENAME%"

Author

Brian Woodward

• github/doowb
• twitter/doowb

License

Copyright (c) 2015 Brian Woodward
Released under the MIT license

---

This file was generated by verb-cli on March 11, 2015.

watch-cli's Issues

Document CLI

Hi,

thanks for the library – I was looking for this. I can't find any documentation for it though – have I missed something?

Maintainer fork 2019

Hi, here is a fork of your great script :
https://www.npmjs.com/package/watch-cli-only
https://github.com/1000i100/watch-cli

I have only keep the essential to drop out outdated dependancies and security breaches.
There should be no functional difference.

Comparison to chokidar

I think watch-cli is easier to find, but chokidar seems more mature. Maybe a note in the repo description pointing towards chokidar makes sense.

command variables

How do I detect in my command which file has changed?

stdio loses color

Hi, thank you for this utility. I noticed that colors get lost in the commands it runs. I have a proposed fix, which I'll push/PR. Cheers.