A simple and flexible CLI tool written in Python that watches a directory for file changes and runs a command automatically — perfect for automation and development workflows.
- Watch any directory for file changes (recursively)
- Run any custom shell command when a change happens
- Ignore files/folders using a
.watcherignorefile - Easy to use CLI (powered by
typer) - Lightweight and cross-platform
clone project
cd file-watcher
uv tool install .uv tool uninstall file-watcherfile-watcher --command "type your command here"touch .watcherignore
add watcher.log to .watcherignore file
nohup file-watcher --command "your command" > watcher.log 2>&1 &
killall file-watcher