#fsevents #notify #inotify #watcher

app caretaker

A simple, configurable filesystem watcher

10 releases

0.2.4 Jun 17, 2022
0.2.3 Jun 10, 2022
0.2.2 Sep 5, 2021
0.2.1 Mar 13, 2021
0.1.2 Jan 15, 2020

#397 in Development tools

24 downloads per month

MIT license

189 lines


Build status Crates.io status Docs

A simple tool that loads a list of paths to watch from a TOML file.

name = "print hello"
path = "src"
command = "echo $EVENT_PATH"

name = "compile sass"
path = "sass/*.sass"
command = "sassc -t compressed sass/style.scss static/style.css"

On a change in the path, it executes the command. Directories are watched recursively. Paths can also be specified with globs. Any shell command can be used, along with pipes and so on. By default, the shell specified in the $SHELL environment variable is used to parse and execute the command. Otherwise, on Unix system, it invokes the default Bourne shell (sh command), on windows cmd.exe. Additionally, each command gets the $EVENT_PATH environment variable, containing the path that changed.

Using notify crate, which provides efficient event handling support for the most operating systems (apart from BSD).


Currently, Caretaker is available on AUR. You can install it with some AUR helper, like yay -S caretaker-bin.

If you have Rust toolchain installed, you can install it with Cargo:

cargo install caretaker


Initialising with a dummy .watch.toml file:

caretaker init



You can also pass another file to load the config from via the -w option.




~116K SLoC