PHPackages                             suhailparad/lara-command-chain - 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. [CLI & Console](/categories/cli)
4. /
5. suhailparad/lara-command-chain

ActiveLibrary[CLI & Console](/categories/cli)

suhailparad/lara-command-chain
==============================

Run predefined chains of commands in Laravel

v1.0.0(9mo ago)27MITPHPPHP >=8.0

Since Sep 11Pushed 9mo agoCompare

[ Source](https://github.com/suhailparad/lara-command-chain)[ Packagist](https://packagist.org/packages/suhailparad/lara-command-chain)[ RSS](/packages/suhailparad-lara-command-chain/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

Laravel Command Chain
=====================

[](#laravel-command-chain)

[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)

**Run predefined chains of Artisan and shell commands in your Laravel application with a single command.**

This package allows you to define “chains” of commands (both Artisan and shell commands like `npm install` or `composer update`) and run them sequentially in a clean, visual way in your terminal.

---

📦 Installation
--------------

[](#-installation)

1. Require the package in your Laravel project (local or via Packagist):

```
composer require suhailparad/lara-command-chain
```

2. (Optional) If developing locally, add repository path in `composer.json`:

```
"repositories": [
    {
        "type": "path",
        "url": "packages/lara-command-chain"
    }
]
```

---

⚙️ Publish Configuration
------------------------

[](#️-publish-configuration)

```
php artisan vendor:publish --tag=command-chain-config
```

This will publish `config/command-chain.php` where you can define your chains.

---

📝 Configuration
---------------

[](#-configuration)

`config/command-chain.php` example:

```
return [
    'chains' => [
        'setup' => [
            'php artisan migrate:fresh',
            'php artisan db:seed',
            'php artisan cache:clear',
        ],
        'deploy' => [
            'php artisan down',
            'composer update',
            'npm install',
            'php artisan migrate',
            'php artisan up',
        ],
    ],
];
```

- Each chain is a named array of commands.
- Commands can be **Artisan commands** (`php artisan ...`) or **shell commands** (`npm install`, `composer update`, `git pull`, etc.).

---

🚀 Usage
-------

[](#-usage)

Run a chain:

```
php artisan chain:run setup
php artisan chain:run deploy
```

### Output Example

[](#output-example)

```
⚡ Running chain: deploy

[1/4] php artisan down ... ✅ done (0.1s)
[2/4] composer update ... 🚀 running...
Updating dependencies...
Generating optimized autoload files...
[2/4] composer update ... ✅ done (6.3s)
[3/4] php artisan migrate ... ✅ done (0.2s)
[4/4] php artisan up ... ✅ done (0.1s)

⚡ Chain [deploy] completed!
```

---

🛠 Dry Run
---------

[](#-dry-run)

Check what commands would run without executing:

```
php artisan chain:run deploy --dry-run
```

Example output:

```
⏭️  [1/4] php artisan down ... skipped (dry run)
⏭️  [2/4] composer update ... skipped (dry run)
⏭️  [3/4] php artisan migrate ... skipped (dry run)
⏭️  [4/4] php artisan up ... skipped (dry run)
```

---

🔧 Features
----------

[](#-features)

- Run **multiple Artisan or shell commands** in sequence.
- ✅ Shows status (done / failed / skipped) with icons.
- ⏱ Shows duration for each command.
- Dry-run support (`--dry-run`) to preview chains.
- Works with long-running commands like `npm install` or `composer update`.
- Fully configurable via `config/command-chain.php`.

---

⚡ Example Chains
----------------

[](#-example-chains)

```
'chains' => [
    'build' => [
        'npm install',
        'npm run build',
    ],
    'deploy' => [
        'php artisan down',
        'composer install',
        'php artisan migrate',
        'php artisan up',
    ],
];
```

Run them:

```
php artisan chain:run build
php artisan chain:run deploy
```

---

📄 Contribution
--------------

[](#-contribution)

1. Fork the repository.
2. Create your feature branch: `git checkout -b feature/new-chain`.
3. Commit your changes: `git commit -m 'Add new chain feature'`.
4. Push to the branch: `git push origin feature/new-chain`.
5. Submit a pull request.

---

⚖️ License
----------

[](#️-license)

MIT License © [Muhammed Suhail](https://github.com/suhailparad)

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance56

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

296d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10265683?v=4)[Muhammed Suhail](/maintainers/suhailparad)[@suhailparad](https://github.com/suhailparad)

---

Top Contributors

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

---

Tags

laravelartisanworkflowcommandsChain

### Embed Badge

![Health badge](/badges/suhailparad-lara-command-chain/health.svg)

```
[![Health](https://phpackages.com/badges/suhailparad-lara-command-chain/health.svg)](https://phpackages.com/packages/suhailparad-lara-command-chain)
```

###  Alternatives

[stepanenko3/nova-command-runner

Laravel Nova tool for running Artisan and bash(shell) commands.

361.0M](/packages/stepanenko3-nova-command-runner)[guratr/nova-command-runner

Laravel Nova tool for running Artisan commands.

43257.3k1](/packages/guratr-nova-command-runner)[vkovic/laravel-commando

Collection of handy Laravel artisan commands that most projects needs

6141.4k](/packages/vkovic-laravel-commando)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)

PHPackages © 2026

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