PHPackages                             christopherpeacock/laravel-job-watcher - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. christopherpeacock/laravel-job-watcher

ActiveLibrary

christopherpeacock/laravel-job-watcher
======================================

A PHP Laravel Job Watcher to auto-restart queue worker on job file changes.

14PHP

Since Jun 13Pushed 11mo agoCompare

[ Source](https://github.com/ChristopherPeacock/laravel-job-watcher)[ Packagist](https://packagist.org/packages/christopherpeacock/laravel-job-watcher)[ RSS](/packages/christopherpeacock-laravel-job-watcher/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Job Watcher
===================

[](#laravel-job-watcher)

Hot reload for Laravel Jobs — automatically restart your queue workers when job files change during development.

Problem
-------

[](#problem)

When working on Laravel Jobs, you often have to stop and restart the queue worker manually to see your code changes take effect. This repetitive process slows down development and wastes time.

Solution
--------

[](#solution)

**Hot Reload for Laravel Jobs** — inspired by JavaScript frameworks, this tool watches the `app/Jobs` directory and automatically restarts the Laravel queue worker whenever it detects PHP file changes. No more manual restarts; just code and watch your changes take effect immediately.

Installation
------------

[](#installation)

Install via composer:

```
composer require christopherpeacock/laravel-job-watcher
```

Usage
-----

[](#usage)

Run from your Laravel project root folder:

```
php vendor/christopherpeacock/laravel-job-watcher/bin/laravel-job-watcher.php
```

The watcher will:

- Monitor the `app/Jobs` directory for any PHP file changes
- Automatically restart the Laravel queue worker upon detecting changes
- Print clear status messages to keep you informed
- Keep your development workflow smooth and uninterrupted

### Example Output

[](#example-output)

```
$ vendor/bin/laravel-job-watcher

```

Requirements
------------

[](#requirements)

- PHP 8.0 or higher
- Laravel 9.0 or higher

How It Works
------------

[](#how-it-works)

The job watcher uses file system events to monitor changes in your job files. When a change is detected:

1. The current queue worker process is gracefully terminated
2. A new queue worker is started automatically
3. Your updated job code is now active without manual intervention

Development Benefits
--------------------

[](#development-benefits)

- **Faster Development**: No more manual queue worker restarts
- **Improved Workflow**: Focus on coding, not process management
- **Real-time Testing**: See your job changes immediately
- **Error Prevention**: Avoid forgetting to restart workers

Credits
-------

[](#credits)

- Christopher Peacock -> ()

---

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/2349361a84df09de79c2b3d7985f9f5748998fd5538f062d592b590f4a4ca82a?d=identicon)[ChristopherPeacock](/maintainers/ChristopherPeacock)

---

Top Contributors

[![ChristopherPeacock](https://avatars.githubusercontent.com/u/122057441?v=4)](https://github.com/ChristopherPeacock "ChristopherPeacock (6 commits)")

### Embed Badge

![Health badge](/badges/christopherpeacock-laravel-job-watcher/health.svg)

```
[![Health](https://phpackages.com/badges/christopherpeacock-laravel-job-watcher/health.svg)](https://phpackages.com/packages/christopherpeacock-laravel-job-watcher)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)