PHPackages gbuckingham89/valet-assistant - 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. [Utility & Helpers](/categories/utility) 4. / 5. gbuckingham89/valet-assistant AbandonedArchivedLibrary[Utility & Helpers](/categories/utility) gbuckingham89/valet-assistant ============================= A Laravel package for using Laravel Valet within another Laravel application - e.g. getting a list of sites served by Valet. 0.2.0(4y ago)0217MITPHPPHP ^7.4|^8.0 Since Dec 28Pushed 4y ago1 watchersCompare [ Source](https://github.com/gbuckingham89/valet-assistant)[ Packagist](https://packagist.org/packages/gbuckingham89/valet-assistant)[ Docs](https://github.com/gbuckingham89/valet-assistant)[ RSS](/packages/gbuckingham89-valet-assistant/feed)WikiDiscussions master Synced 3w ago READMEChangelog (2)Dependencies (7)Versions (3)Used By (0) Valet Assistant =============== [](#valet-assistant) [![Latest Version on Packagist](https://camo.githubusercontent.com/4345ae18be63ba5c2b6e718307272ca7d3e59f46e85e31900f0d6abb804af749/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f676275636b696e6768616d38392f76616c65742d617373697374616e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gbuckingham89/valet-assistant)[![GitHub Tests Action Status](https://camo.githubusercontent.com/5f55e492fca308974e796e310feb0ca03f98fc9930647c60546c4902e03e13f0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f676275636b696e6768616d38392f76616c65742d617373697374616e742f54657374733f6c6162656c3d7465737473)](https://github.com/gbuckingham89/valet-assistant/actions?query=workflow%3Atests+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/1a60868a08387745d9cd9acfc7204dc53c0170835a324f9fd4842424b78c502f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f676275636b696e6768616d38392f76616c65742d617373697374616e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gbuckingham89/valet-assistant) A Laravel package for using [Laravel Valet](https://laravel.com/docs/valet) within another Laravel application - e.g. getting a list of sites served by Valet. *This package will only be fully functional when used on a computer that has Laravel Valet installed.* **Looking for a UI for Laravel Valet? Take a look at [gbuckingham89/valet-launchpad](https://github.com/gbuckingham89/valet-launchpad).** Installation ------------ [](#installation) You can install the package via composer: ``` composer require gbuckingham89/valet-assistant ``` You can publish the Laravel config file with: ``` php artisan vendor:publish --tag="valet-assistant-config" ``` Usage ----- [](#usage) Use the [Laravel container](https://laravel.com/docs/container) to resolve a copy of `Gbuckingham89\ValetAssistant\ValetAssistant` however you feel is best - e.g. dependency injection or via `app()->make()`. There is also a Facade, `Gbuckingham89\ValetAssistant\Facade\ValetAssistant`, if that's your preference. Once you have your instance, you can use the following methods: **Get a list of all the projects served by Laravel Valet:** ``` $valetSites = $valetAssistant()->projects(); ``` This returns a Collection of "Project" objects (representing a directory on your local machine). Each Project will have one or more "Site" objects (representing a URL that the project is served under). Take a look at the source code or use auto-completion in your IDE to learn more about the data structure. **Check is Valet is installed (and accessible):** ``` $valetIsInstalled = $valetAssistant()->isInstalled(); ``` This simply returns a boolean value indicating if Valet is installed, or not. Troubleshooting --------------- [](#troubleshooting) ### Valet not installed [](#valet-not-installed) If you see errors about Valet not being installed (but you're sure that it is, and you see output by running `which valet` from your local terminal) it's likely that the user running your PHP script doesn't know where the Valet binary is located, or doesn't have permission to run it. There are two ways to resolve this; 1. Find the value of the PATH environment variable for your shell by running `echo $PATH` from your local Terminal. Ensure you have published the config file (see above), then add an entry to your `.env` file with the key `VALET_ASSISTANT_ENV_PATH` and the value of your local PATH. This PATH value will then be used whenever this package executes a shell command. It is NOT used by code outside this package. 2. Add `/Users/[local-username]/.composer/vendor/bin` to the PATH environment for the user running the PHP script *(remember to insert the username that Valet is installed under)* ***Please do your own research and consider any security implications of giving PHP access to additional directories through the PATH environment.*** Testing ------- [](#testing) You can run the test suite by calling `./vendor/bin/phpunit` or `composer test`. *You may see the following error in your terminal output when running the test suite: `..sh: which: command not found`. This is a [known issue](https://github.com/gbuckingham89/valet-assistant/blob/master/tests/Unit/Commander/ExecCommanderTest.php#L38) and a PR to resolve this would certainly be welcomed!* Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [George Buckingham](https://github.com/gbuckingham89) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 23 — LowBetter than 26% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity46 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 Every ~8 days Total 2 Last Release 1632d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/22ec38c802df71e6286b262e605a1b445f2657b8f834db0098d10a06c9ec1137?d=identicon)[gbuckingham89](/maintainers/gbuckingham89) --- Top Contributors [![gbuckingham89](https://avatars.githubusercontent.com/u/1455253?v=4)](https://github.com/gbuckingham89 "gbuckingham89 (6 commits)") --- Tags valetValet APILaravel ValetLaravel Valet API ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/gbuckingham89-valet-assistant/health.svg) ``` [![Health](https://phpackages.com/badges/gbuckingham89-valet-assistant/health.svg)](https://phpackages.com/packages/gbuckingham89-valet-assistant) ``` ### Alternatives [firefly-iii/data-importer Firefly III Data Import Tool. 7965.8k](/packages/firefly-iii-data-importer)[markwalet/nova-modal-response A Laravel Nova asset for Modal responses on an action. 17818.7k](/packages/markwalet-nova-modal-response)[crumbls/layup A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets. 591.7k1](/packages/crumbls-layup)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.2k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)