A simple CLI tool to watch for file changes in your Laravel project and automatically run a custom command — ideal for hot-reloading Laravel Octane in development.
Inspired by Laravel Octane with developer happiness in mind.
- 📦 Watches all files in the project
- 🔁 Automatically runs a command (like
php artisan octane:reload) on changes - 🧠 Ignores paths listed in a
.watcherignorefile (like.gitignore) - ⚡ Lightweight and fast (powered by chokidar)
- 🎯 Perfect for Docker + Laravel Octane development environments
cd to project root
npm i
npm install -g .watcher "your-reload-command-here"Examples:
watcher "make reload"watcher "docker exec php-octane php artisan octane:reload"watcher "docker compose exec app php artisan octane:reload"You can create a .watcherignore file in the root of your project to prevent reloading on certain files or folders.
Example .watcherignore file:
node_modules
vendor
storage/logs
public/storage
.gitLaravel Octane doesn’t reload automatically on file changes inside Docker. This tool bridges the gap by watching your files and reloading Octane only when needed — clean, minimal, no unnecessary reloads.
Created with ❤️ by [hossein shafiei].
Feel free to contribute or suggest features.
MIT