PHPackages                             acquia/blt-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. acquia/blt-launcher

AbandonedArchivedLibrary

acquia/blt-launcher
===================

Provides a BLT executable for your global PATH

v1.1.0(4y ago)29332[1 issues](https://github.com/acquia/blt-launcher/issues)[1 PRs](https://github.com/acquia/blt-launcher/pulls)GPL-2.0-or-laterPHP

Since Oct 1Pushed 3y ago6 watchersCompare

[ Source](https://github.com/acquia/blt-launcher)[ Packagist](https://packagist.org/packages/acquia/blt-launcher)[ RSS](/packages/acquia-blt-launcher/feed)WikiDiscussions master Synced today

READMEChangelog (6)Dependencies (6)Versions (7)Used By (0)

BLT Launcher
============

[](#blt-launcher)

A small wrapper around BLT for your global $PATH.

Why?
----

[](#why)

BLT must be installed on a per-project basis via Composer (`composer require acquia/blt`). This makes BLT available to your project by placing it at `vendor/bin/blt`.

However, it is inconvenient to type `vendor/bin/blt` in order to execute BLT commands. By installing the BLT launcher globally on your local machine, you can simply type `blt` on the command line, and the launcher will find and execute the project specific version of BLT 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/acquia/blt-launcher/releases/latest/download/blt.phar
    ```

    Linux:

    ```
    wget -O blt.phar https://github.com/acquia/blt-launcher/releases/latest/download/blt.phar
    ```
2. Make downloaded file executable: `chmod +x blt.phar`
3. Move blt.phar to a location listed in your `$PATH`, rename to `blt`:

    ```
    sudo mv blt.phar /usr/local/bin/blt
    ```
4. Windows users: create a blt.bat file in the same folder as blt.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\blt.phar" %*
    ```

Update
------

[](#update)

The BLT Launcher Phar is able to self update to the latest release.

```
    blt 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. BLT is smart enough to find the PROJECT\_ROOT and DRUPAL\_ROOT when it is run from the bin directory.

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

[](#xdebug-compatibility)

BLT Launcher, like Composer automatically disables Xdebug by default. This improves performance substantially. You may override this feature by setting an environment variable. `BLT_ALLOW_XDEBUG=1 blt [command]`

Credit / Kudos
--------------

[](#credit--kudos)

Many thanks to the Drush team for their excellent [Drush Launcher](https://github.com/drush-ops/drush-launcher), upon which BLT Launcher is based.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity58

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

Recently: every ~99 days

Total

6

Last Release

1646d ago

Major Versions

v0.1.0 → v1.0.02020-10-01

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/514789?v=4)[Acquia](/maintainers/acquia)[@acquia](https://github.com/acquia)

![](https://avatars.githubusercontent.com/u/1984514?v=4)[Dane Powell](/maintainers/danepowell)[@danepowell](https://github.com/danepowell)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/acquia-blt-launcher/health.svg)

```
[![Health](https://phpackages.com/badges/acquia-blt-launcher/health.svg)](https://phpackages.com/packages/acquia-blt-launcher)
```

###  Alternatives

[vimeo/psalm

A static analysis tool for finding errors in PHP applications

5.8k77.5M6.7k](/packages/vimeo-psalm)[phan/phan

A static analyzer for PHP

5.6k11.2M1.1k](/packages/phan-phan)[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M1.9k](/packages/behat-behat)[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k26.2M1.8k](/packages/infection-infection)[beyondcode/expose

Create public URLs for local sites through any firewall and VPN.

4.5k437.3k3](/packages/beyondcode-expose)[humbug/box

Fast, zero config application bundler with PHARs.

1.3k801.5k68](/packages/humbug-box)

PHPackages © 2026

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