PHPackages cav-s-a/nova-advanced-command-runner - 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. cav-s-a/nova-advanced-command-runner ActiveLibrary[CLI & Console](/categories/cli) cav-s-a/nova-advanced-command-runner ==================================== Laravel Nova tool for running Artisan and bash(shell) commands. v3.0.1.7(5y ago)02.7kMITPHPPHP >=7.1.0 Since Jun 11Pushed 5y agoCompare [ Source](https://github.com/cav-s-a/nova-advanced-command-runner)[ Packagist](https://packagist.org/packages/cav-s-a/nova-advanced-command-runner)[ RSS](/packages/cav-s-a-nova-advanced-command-runner/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (13)Used By (0) Laravel Nova tool for running Artisan & Shell commands. =========================================================== [](#laravel-nova-tool-for-running-artisan--shell-commands) This [Nova](https://nova.laravel.com) tool lets you run artisan and bash commands directly from nova. > This is an extended version of the original package [Nova Command Runner](https://github.com/guratr/nova-command-runner) by [guratr](https://github.com/guratr) Features -------- [](#features) - Run predefined artisan and shell commands - Run custom artisan and shell commands - Use variables while running commands - Prompt the user to specify optional flags while running commands - Use predefined values for variables using a select box or prompt the user to enter a value for the variable. - Keep track of command run history - No database changes required. Everything is managed from a single config file. - Queue long running commands [![screenshot of the command runner tool](screenshots/tool.png)](screenshots/tool.png) Installation ------------ [](#installation) You can install the nova tool in to a Laravel app that uses [Nova](https://nova.laravel.com) via composer: ``` composer require binarybuilds/nova-advanced-command-runner ``` Next up, you must register the tool with Nova. This is typically done in the `tools` method of the `NovaServiceProvider`. ``` // in app/Providers/NovaServiceProvder.php // ... public function tools() { return [ // ... new \BinaryBuilds\NovaAdvancedCommandRunner\CommandRunner, ]; } ``` Publish the config file: ``` php artisan vendor:publish --provider="BinaryBuilds\NovaAdvancedCommandRunner\ToolServiceProvider" ``` Add your commands to `config/nova-advanced-command-runner.php` Usage ----- [](#usage) Click on the `"Command Runner"` menu item in your Nova app to see the tool. Configuration ------------- [](#configuration) All the configuration is managed from a single configuration file located in `config/nova-advanced-command-runner.php` ### Adding Commands [](#adding-commands) All the commands which needs to be easily accessible should be defined in the `commands` array in the configuration file. #### Command Options [](#command-options) - run : command to run (E.g. route:cache) - type : button class (primary, secondary, success, danger, warning, info, light, dark, link) - group: Group name (optional) - variables : Array of variables used in the command(optional) - command\_type : Type of the command.(artisan or bash. Default artisan) - flags : Array of optional flags for the command(optional) #### Examples [](#examples) ``` 'commands' => [ // Basic command 'Clear Cache' => [ 'run' => 'cache:clear', 'type' => 'danger', 'group' => 'Cache', ], // Bash command 'Disk Usage' => [ 'run' => 'df -h', 'type' => 'danger', 'group' => 'Statistics', 'command_type' => 'bash' ], // Command with variable 'Clear Cache' => [ 'run' => 'cache:forget {cache key}', 'type' => 'danger', 'group' => 'Cache' ], // Command with advanced variable customization 'Clear Cache' => [ 'run' => 'cache:forget {cache key}', 'type' => 'danger', 'group' => 'Cache', 'variables' => [ [ 'label' => 'cache key' // This needs to match with variable defined in the command, 'field' => 'select' // Allowed values (text,number,tel,select,date,email,password), 'options' => [ 'blog-cache' => 'Clear Blog Cache', 'app-cache' => 'Clear Application Cache' ], 'placeholder' => 'Select An Option' ] ] ], // Command with flags 'Run Migrations' => [ 'run' => 'migrate --force', 'type' => 'danger', 'group' => 'Migration', ], // Command with optional flags 'Run Migrations' => [ 'run' => 'migrate', 'type' => 'danger', 'group' => 'Migration', 'flags' => [ // These optional flags will be prompted as a checkbox for the user // And will be appended to the command if the user checks the checkbox '--force' => 'Force running in production' ] ], // Command with help text 'Run Migrations' => [ 'run' => 'migrate --force', 'type' => 'danger', 'group' => 'Migration', // You can also add html for help text. 'help' => 'This is a destructive operation. Proceed only if you really know what you are doing.' ], // Queueing commands 'Clear Cache' => [ 'run' => 'cache:clear --should-queue', 'type' => 'danger', 'group' => 'Cache' ], // Queueing commands on custom queue and connection 'Clear Cache' => [ 'run' => 'cache:clear --should-queue --cr-queue=high --cr-connection=database', 'type' => 'danger', 'group' => 'Cache' ], ] ``` ### Other Customizations [](#other-customizations) ``` // Limit the command run history to latest 10 runs 'history' => 10, // Tool name displayed in the navigation menu 'navigation_label' => 'Command Runner', // Any additional info to display on the tool page. Can contain string and html. 'help' => '', // Allow running of custom artisan and bash(shell) commands 'custom_commands' => ['artisan','bash'], // Allow running of custom artisan commands only(disable custom bash(shell) commands) 'custom_commands' => ['artisan'], // Allow running of custom bash(shell) commands only(disable custom artisan commands) 'custom_commands' => ['bash'], // Disable running of custom commands. 'custom_commands' => [], ``` ### Screenshots [](#screenshots) [![screenshot of the command runner tool](screenshots/tool.png)](screenshots/tool.png) [![screenshot of the command runner tool](screenshots/confirmation.png)](screenshots/confirmation.png) [![screenshot of the command runner tool](screenshots/variable-input.png)](screenshots/variable-input.png) [![screenshot of the command runner tool](screenshots/select-variable.png)](screenshots/select-variable.png) [![screenshot of the command runner tool](screenshots/command-with-optional-flag.png)](screenshots/command-with-optional-flag.png) Credits ------- [](#credits) - [Srinath Reddy Dudi(Author & Maintainer)](https://github.com/srinathreddydudi) - [guratr(Author of original package)](https://github.com/guratr) Contributing ------------ [](#contributing) Thank you for considering contributing to this package! Please create a pull request with your contributions with detailed explanation of the changes you are proposing. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you found a security vulnerability with in this package, Please do not use the issue tracker. Instead send an email to `srinathreddydudi@gmail.com`. All security vulnerabilities are addressed promptly. License ------- [](#license) This package is open-sourced software licensed under the [MIT license](LICENSE.md). ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity19 Limited adoption so far Community9 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 50% 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 Every ~17 days Recently: every ~0 days Total 11 Last Release 1987d ago Major Versions v1.0.0 → v2.0.02020-06-21 v2.0.0 → v3.0.02020-08-09 ### Community Maintainers ![](https://www.gravatar.com/avatar/229f562446f8a35ac4ff8a791ff205984925d9f6b373cb3de17eab146586dbcf?d=identicon)[rramoscav](/maintainers/rramoscav) --- Top Contributors [![robertolacav](https://avatars.githubusercontent.com/u/70906954?v=4)](https://github.com/robertolacav "robertolacav (18 commits)")[![guratr](https://avatars.githubusercontent.com/u/1502853?v=4)](https://github.com/guratr "guratr (12 commits)")[![srinathreddydudi](https://avatars.githubusercontent.com/u/10626045?v=4)](https://github.com/srinathreddydudi "srinathreddydudi (6 commits)") --- Tags laravelshellartisancommandsnovabash ### Embed Badge ![Health badge](/badges/cav-s-a-nova-advanced-command-runner/health.svg) ``` [![Health](https://phpackages.com/badges/cav-s-a-nova-advanced-command-runner/health.svg)](https://phpackages.com/packages/cav-s-a-nova-advanced-command-runner) ``` ### Alternatives [stepanenko3/nova-command-runner Laravel Nova tool for running Artisan and bash(shell) commands. 36983.0k](/packages/stepanenko3-nova-command-runner)[guratr/nova-command-runner Laravel Nova tool for running Artisan commands. 43232.8k1](/packages/guratr-nova-command-runner)[vkovic/laravel-commando Collection of handy Laravel artisan commands that most projects needs 6139.2k](/packages/vkovic-laravel-commando)[tomatophp/filament-artisan Simple but yet powerful library for running some artisan commands for FilamentPHP 3269.1k1](/packages/tomatophp-filament-artisan) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)