PHPackages                             vinkius-labs/workaholic - 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. [Queues &amp; Workers](/categories/queues)
4. /
5. vinkius-labs/workaholic

ActiveLibrary[Queues &amp; Workers](/categories/queues)

vinkius-labs/workaholic
=======================

Workaholic is an advanced Laravel package designed to streamline queue and schedule management with intelligent scaling, real-time monitoring, and detailed statistics. It offers a comprehensive solution for optimizing asynchronous tasks and cron-based commands, featuring auto-discovery, auto-scaling, and a web-based dashboard for managing both queue workers and scheduled jobs efficiently.

10PHP

Since Oct 25Pushed 6mo agoCompare

[ Source](https://github.com/vinkius-labs/workaholic)[ Packagist](https://packagist.org/packages/vinkius-labs/workaholic)[ RSS](/packages/vinkius-labs-workaholic/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Workaholic
==========

[](#workaholic)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e671b0b3b2853ff8311cfa742a2d63265a7b205b4ee4dc61b023406ecbb69f50/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76696e6b6975732d6c6162732f776f726b61686f6c69632e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vinkius-labs/workaholic)[![Total Downloads](https://camo.githubusercontent.com/38b47dbfa8b218bf1f69cb652eb54417363eabda9b9d1975679173e02d3801b0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f76696e6b6975732d6c6162732f776f726b61686f6c69632e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vinkius-labs/workaholic)[![License](https://camo.githubusercontent.com/01c6118128026785f1df7dbc37c3b878fa39af2f146fcbd0f1914a9293b8f35c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f76696e6b6975732d6c6162732f776f726b61686f6c69632e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vinkius-labs/workaholic)

**An advanced Laravel queue manager that optimizes async processing with intelligent scaling, real-time monitoring, and detailed statistics.**

[![20250730_1948_Personagens da Logo_remix_01k1eafbcwfbcvwh07gdcxzvde](https://private-user-images.githubusercontent.com/26571/473024897-4f2d06d1-4ee4-47d4-b1e6-5f983eabee57.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzM5MzMwMDMsIm5iZiI6MTc3MzkzMjcwMywicGF0aCI6Ii8yNjU3MS80NzMwMjQ4OTctNGYyZDA2ZDEtNGVlNC00N2Q0LWIxZTYtNWY5ODNlYWJlZTU3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzE5VDE1MDUwM1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdhZjUxNjExMzYzMzUxOWQzYjBlZmU1OWFhM2VkMTI0YmYyNTNjNTUzN2E5ODI2MjI5MWM5MzYyMjUwMjZkYzUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.uChW7nPK33WDTPMUdnASypwiAdXSnOTdLVrttniJxIo)](https://private-user-images.githubusercontent.com/26571/473024897-4f2d06d1-4ee4-47d4-b1e6-5f983eabee57.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzM5MzMwMDMsIm5iZiI6MTc3MzkzMjcwMywicGF0aCI6Ii8yNjU3MS80NzMwMjQ4OTctNGYyZDA2ZDEtNGVlNC00N2Q0LWIxZTYtNWY5ODNlYWJlZTU3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzE5VDE1MDUwM1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdhZjUxNjExMzYzMzUxOWQzYjBlZmU1OWFhM2VkMTI0YmYyNTNjNTUzN2E5ODI2MjI5MWM5MzYyMjUwMjZkYzUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.uChW7nPK33WDTPMUdnASypwiAdXSnOTdLVrttniJxIo)### ⚠️ **DEVELOPMENT STATUS** ⚠️

[](#️-development-status-️)

**This package is currently under active development and is NOT production-ready.**

Please do not use in production environments. APIs and features may change without notice.

---

Overview
--------

[](#overview)

Workaholic is a high-performance, feature-rich Laravel queue worker manager that enhances your application's asynchronous processing capabilities. It provides intelligent worker scaling, health monitoring, and comprehensive statistics to ensure your queues operate efficiently even under heavy loads.

Key features
------------

[](#key-features)

- 🔄 **Auto-discovery** of queue channels from environment variables
- 📊 **Real-time monitoring** with detailed metrics and health checks
- ⚡ **Multi-worker management** with optimized resource allocation
- 🤖 **Auto-scaling** based on queue load and system metrics
- 📲 **Interactive dashboard** for visualizing and managing your queues in real-time
- 🧰 **Comprehensive CLI tools** for queue operations
- 🔍 **Daemon mode** with automatic health monitoring and recovery

> **⚠️ Alpha Stage:** Workaholic is currently in alpha development. While we welcome testing and feedback, please avoid using it in production environments until the stable 1.0.0 release.

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

[](#requirements)

- PHP 8.0+
- Laravel 9.0+, 10.0+, 11.0+, 12.0+
- Redis server (for queue and metrics storage)

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

[](#installation)

```
# Install via Composer
composer require vinkius-labs/workaholic
```

After installing Workaholic, the package will automatically:

- Publish the configuration file to `config/workaholic.php`
- Publish assets to your public directory
- Run migrations to set up the necessary database tables

You can also manually install the package by running:

```
php artisan workaholic:install
```

Updating
--------

[](#updating)

Workaholic is designed to update automatically whenever you run `composer update`. During an update:

1. All assets will be republished
2. New migrations will run automatically
3. Routes will be reloaded
4. Laravel cache will be cleared

For more information:

- [Detailed Updating Guide](docs/updating.md)
- [How Auto-Updates Work](docs/auto-updates.md)

Configuration
-------------

[](#configuration)

### Environment Variables

[](#environment-variables)

Workaholic uses a flexible configuration system based on environment variables:

```
# Example queue channel configurations
WORKAHOLIC_CHANNELS_EMAIL_WORKERS=5
WORKAHOLIC_CHANNELS_EMAIL_MEMORY=256
WORKAHOLIC_CHANNELS_EMAIL_TIMEOUT=300
WORKAHOLIC_CHANNELS_EMAIL_PRIORITY=high

WORKAHOLIC_CHANNELS_DEFAULT_WORKERS=3
WORKAHOLIC_CHANNELS_DEFAULT_MEMORY=128
WORKAHOLIC_CHANNELS_DEFAULT_TIMEOUT=120
WORKAHOLIC_CHANNELS_DEFAULT_PRIORITY=medium
```

### Redis Configuration

[](#redis-configuration)

Workaholic relies on Redis for queue management and metrics storage:

```
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
```

Quick Start
-----------

[](#quick-start)

```
# Start queue workers with auto-discovery
php artisan workaholic:queue start

# View worker status
php artisan workaholic:queue status

# Monitor health with continuous updates
php artisan workaholic:queue health --watch

# Run in daemon mode with auto-scaling
php artisan workaholic:queue daemon --auto-scale
```

Features
--------

[](#features)

### Intelligent Worker Management

[](#intelligent-worker-management)

```
# Start workers for specific channels
php artisan workaholic:queue start --channels=emails,notifications

# Override worker configuration
php artisan workaholic:queue start --workers=5 --memory=256 --timeout=60
```

### Real-time Monitoring

[](#real-time-monitoring)

```
# Watch queue status in real-time
php artisan workaholic:queue status --watch

# Get detailed statistics
php artisan workaholic:queue stats --json
```

### Health Checks and Diagnostics

[](#health-checks-and-diagnostics)

```
# Run a comprehensive health check
php artisan workaholic:queue health

# Watch health in real-time
php artisan workaholic:queue health --watch
```

### Daemon Mode with Supervision

[](#daemon-mode-with-supervision)

```
# Run in daemon mode with health monitoring and auto-recovery
php artisan workaholic:queue daemon --auto-scale
```

Documentation
-------------

[](#documentation)

For comprehensive documentation, check the [`/docs`](docs/) directory or visit our [documentation site](https://github.com/vinkius-labs/workaholic/docs).

🧪 Testing
---------

[](#-testing)

```
composer test
```

Security
--------

[](#security)

If you discover a security vulnerability, please send an email to VinkiusLabs at . All security vulnerabilities will be promptly addressed.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Credits
-------

[](#credits)

- **[Vinkius Labs](https://labs.vinkius.com)** - Package development and maintenance
- **[Contributors](https://github.com/vinkius-labs/workaholic/contributors)** - Community contributions

---

Built with ❤️ by [Vinkius Labs](https://labs.vinkius.com)

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance46

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

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/c115f2233ad835e7b1374faa198dd5c0188174cc861e1efa5f25a9e49f5f604c?d=identicon)[renatomarinho](/maintainers/renatomarinho)

---

Top Contributors

[![renatomarinho](https://avatars.githubusercontent.com/u/26571?v=4)](https://github.com/renatomarinho "renatomarinho (70 commits)")

---

Tags

asynchronoushigh-performancelaravellaravel-frameworklaravel-jolaravel-packagephpqueueworker-poolworkers

### Embed Badge

![Health badge](/badges/vinkius-labs-workaholic/health.svg)

```
[![Health](https://phpackages.com/badges/vinkius-labs-workaholic/health.svg)](https://phpackages.com/packages/vinkius-labs-workaholic)
```

###  Alternatives

[league/geotools

Geo-related tools PHP 7.3+ library

1.4k5.3M26](/packages/league-geotools)[amphp/parser

A generator parser to make streaming parsers simple.

14952.8M16](/packages/amphp-parser)[amphp/serialization

Serialization tools for IPC and data storage in PHP.

13451.1M18](/packages/amphp-serialization)[enqueue/enqueue

Message Queue Library

19820.0M56](/packages/enqueue-enqueue)[deliciousbrains/wp-background-processing

WP Background Processing can be used to fire off non-blocking asynchronous requests or as a background processing tool, allowing you to queue tasks.

1.1k409.8k6](/packages/deliciousbrains-wp-background-processing)[react/async

Async utilities and fibers for ReactPHP

2238.8M170](/packages/react-async)

PHPackages © 2026

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