Install inotify-tools if not present: sudo apt-get install inotify-tools (Debian/Ubuntu) or equivalent.
Wait for a single event then exit: inotifywait -e close_write /path/to/file
Run in daemon mode watching a directory for multiple events: inotifywait -m -r -e create,modify,delete /path/to/dir
Parse the output in a shell loop: inotifywait -m -r -e create /path/to/dir | while read -r dir event file; do echo "$event $dir$file"; done
Use --format to control output: inotifywait -m -e create --format '%w%f' /path/to/dir
Known gotchas
inotifywait -r on a large directory tree may exceed the system's inotify watch limit; check /proc/sys/fs/inotify/max_user_watches and raise it with sysctl fs.inotify.max_user_watches=<VALUE> if needed.
inotify watches are per-inode, not per-path; watching a directory does not automatically watch newly created subdirectories unless -r is used to re-establish recursive watches.
inotify events do not indicate which process caused the change; use auditd or fanotify-based tools if you need process attribution.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp