A simple terminal utility that helps devs run commands (eg. build commands) whenever the specifed file is changed.
Reloop is a lightweight terminal utility that monitors file changes in real-time and executes custom commands whenever a file is modified. Designed for developers and sysadmins, it can run in the background as a daemon and supports logging, configurable watched files, and flexible command execution.
- Real-time file monitoring.
- Background daemon mode (--background) to run without occupying a terminal
- Custom commands on file change (--command "your-command")
- Flexible file watching (--watchfile <path/complete_path_from_root>)
- Optional logging to a file (--logfile <path/complete_path_from_root>)
- Cross-platform compatible (Linux/macOS with minor tweaks)
- Simple, single C++ binary—no dependencies beyond the standard library and FileWatch
Follow these steps to install the utility.
-
Clone the repository:
git clone https://github.com/xZepyx/reloop.git ~/Documents/Reloop cd ~/Documents/Reloop
-
Run the installer:
cd src && bash install.sh
- The installer will compile and install the utility to /usr/bin/reloop
-
Installtion complete now enjoy the power and simplicity of reloop.
- ./reloop [--background] [--logfile ] [--watchfile ] [--help]
- --background : Run the program as a background daemon.
- --command : Command to execute on file change (in quotes).
- --logfile : Specify a log file to redirect output.
- --watchfile : Specify the file to watch for changes.
- --help : Display this help message.
Contributions are welcome. When contributing:
- Open concise issues after confirming the problem isn't caused by local machine.
- Submit focused PRs with clear descriptions and tests where applicable.
- Follow code structure and naming conventions used in
src/.
See CONTRIBUTING.md for full contribution guidelines.
- Maintainer: xZepyx (Aditya Yadav)
- Contact: zepyxunderscore@gmail.com
- WatchFile header.
- C++ (Obvisouly)
© 2025 xZepyx (Aditya Yadav) — Licensed under the MIT License.