PHPackages                             leymannx/wp-cli-launcher - 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. leymannx/wp-cli-launcher

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

leymannx/wp-cli-launcher
========================

Provides a WP-CLI executable for your global PATH

0.0.20(7y ago)010GPL-2.0-or-laterPHP

Since Jul 4Pushed 7y ago2 watchersCompare

[ Source](https://github.com/leymannx/wp-cli-launcher)[ Packagist](https://packagist.org/packages/leymannx/wp-cli-launcher)[ RSS](/packages/leymannx-wp-cli-launcher/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (2)Versions (20)Used By (0)

WP-CLI Launcher
===============

[](#wp-cli-launcher)

A small wrapper around WP-CLI for your global $PATH.

Why?
----

[](#why)

In order to avoid dependency issues, it is best to require WP-CLI on a per-project basis via Composer (`composer require wp-cli/wp-cli`). This makes WP-CLI available to your project by placing it at `vendor/bin/wp`.

However, it is inconvenient to type `vendor/bin/wp` in order to execute WP-CLI commands. By installing the WP-CLI Launcher globally on your local machine, you can simply type `wp` on the command line, and the launcher will find and execute the project specific version of WP-CLI located in your project's `vendor` directory.

Installation - Phar
-------------------

[](#installation---phar)

1. Download latest stable release via CLI (code below) or browse to .

    OSX:

    ```
    curl -OL https://github.com/leymannx/wp-cli-launcher/releases/download/0.0.20/wp-cli.phar
    ```

    Linux:

    ```
    wget -O wp-cli.phar https://github.com/leymannx/wp-cli-launcher/releases/download/0.0.20/wp-cli.phar
    ```
2. Make downloaded file executable:

    ```
    chmod +x wp-cli.phar
    ```
3. Move wp-cli.phar to a location listed in your `$PATH`, rename to `wp`:

    ```
    sudo mv wp-cli.phar /usr/local/bin/wp
    ```
4. Windows users: create a wp-cli.bat file in the same folder as wp-cli.phar with the following lines. This gets around the problem where Windows does not know that .phar files are associated with `php`:

    ```
    @echo off
    php "%~dp0\wp-cli.phar" %*
    ```

Update
------

[](#update)

The WP-CLI Launcher Phar is able to self update to the latest release.

```
wp self-update
```

Alternatives
------------

[](#alternatives)

If you only have one codebase on your system (typical with VMs, Docker, etc,), you should add `/path/to/vendor/bin` to your $PATH.

Fallback
--------

[](#fallback)

When a site-local WP-CLI is not found, this launcher usually throws a helpful error. You may avoid the error and instead hand off execution to a global WP-CLI (any version) by doing *either* of:

1. Export an environment variable: `export WP_CLI_LAUNCHER_FALLBACK=/path/to/wp`
2. Specify an option: `--fallback=/path/to/wp`

Xdebug compatibility
--------------------

[](#xdebug-compatibility)

WP-CLI Launcher, like Composer automatically disables Xdebug by default. This improves performance substantially. You may override this feature by setting an environment variable. `WP_CLI_ALLOW_XDEBUG=1 wp [command]`

License
-------

[](#license)

GPL-2.0+

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 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 ~4 days

Total

19

Last Release

2834d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f3db6cbd4ec1a6ceed59498ba288ced080af2e53803aa060f24c47e05e069be3?d=identicon)[leymannx](/maintainers/leymannx)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/leymannx-wp-cli-launcher/health.svg)

```
[![Health](https://phpackages.com/badges/leymannx-wp-cli-launcher/health.svg)](https://phpackages.com/packages/leymannx-wp-cli-launcher)
```

###  Alternatives

[acmephp/acmephp

Let's Encrypt client written in PHP

649157.7k](/packages/acmephp-acmephp)[puli/cli

A Command Line Interface (CLI) for managing Puli projects.

5147.3k14](/packages/puli-cli)

PHPackages © 2026

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