PHPackages                             baleen/cli - 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. [Database & ORM](/categories/database)
4. /
5. baleen/cli

AbandonedArchivedLibrary[Database & ORM](/categories/database)

baleen/cli
==========

Console wrapper for Baleen Migrations

0.5.1(10y ago)72683MITPHP

Since Jul 21Pushed 10y ago1 watchersCompare

[ Source](https://github.com/baleen/cli)[ Packagist](https://packagist.org/packages/baleen/cli)[ RSS](/packages/baleen-cli/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (14)Versions (12)Used By (0)

Baleen CLI
==========

[](#baleen-cli)

[![Build Status](https://camo.githubusercontent.com/b8f23e1016d4bb74be339e0063ffa25d4bc8433923a30d50a64621ff02f42c94/68747470733a2f2f7472617669732d63692e6f72672f62616c65656e2f636c692e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/baleen/cli)[![Code Coverage](https://camo.githubusercontent.com/19e636c52ff5b466865e5cb887062d619675010646ef56d86852ec1562140a85/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62616c65656e2f636c692f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/baleen/cli/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/f8a87216bef10beead2ab36dbd8bc6e8504f03771e67d8f58979dd58cafb8267/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62616c65656e2f636c692f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/baleen/cli/?branch=master)[![Packagist](https://camo.githubusercontent.com/2a1c50fc7eb0501bbea825cb5c9184737120705de5c1de9bdfc1dcf3b474875b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62616c65656e2f636c692e737667)](https://packagist.org/packages/baleen/cli)

[![Author](https://camo.githubusercontent.com/8222d6eef0fd941ecf7f9af423740d2b4255ecd50069439241f2fa79f026d1f8/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406761627269656c5f736f6d6f7a612d626c75652e737667)](https://twitter.com/gabriel_somoza)[![License](https://camo.githubusercontent.com/e083ef78793e1897e33cce75814c75e37e3a83457ab13b9aba9b109f82a99617/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f62616c65656e2f636c692e737667)](https://github.com/baleen/cli/blob/master/LICENSE)

Generic, customisable command-line wrapper for Baleen Migrations.

Installation
------------

[](#installation)

With Composer:

```
composer install baleen/cli
```

Baleen CLI is quite opinionated in its defaults, so it doesn't need extra configuration to run. So if you'd like to just test-drive the project, you can now jump straight to the "usage" section.

But you can customize almost anything through a configuration file. To create a configuration file, run the following:

```
./vendor/bin/baleen init
```

This will generate two files in your working directory:

- `.baleen.yml`: the configuration file.
- `.baleen_versions`: a simple file to keep track of which versions have been migrated. This can later be replaced with a database table. You may want to ignore this file in your VCS system (e.g. using Git's `.gitignore` file).

The `.baleen_versions` file will be created for you automatically if you use the default configuration values. You don't need to run `baleen init` in order for the file to be created.

If you don't want to type `./vendor/bin/baleen` to run baleen commands then you can alternatively use Composer as a shortcut. Just edit your project's `composer.json` file to add the following:

```
{
   "scripts": {
       "baleen": "vendor/bin/baleen --ansi"
   }
}
```

Now you can run Baleen CLI easily by just typing `composer baleen`!

Usage
-----

[](#usage)

To see some help and a list of available commands, simply execute:

```
./vendor/bin/baleen
```

For more help on a specific command simply run `./vendor/bin/baleen help {command}`, replacing `{command}` with the name of an available command.

### Creating Migrations

[](#creating-migrations)

Migrations are stored by default under the `./migrations` directory, which will be automatically created every time your run a commend if it doesn't exist.

You can customise which directory to use for migrations, as well as the namespace for migration classes by editing the `.baleen.yml` config file.

To easily create a new Migration file run the following command:

```
./vendor/bin/baleen migrations:create
```

### Running Migrations

[](#running-migrations)

Running migrations is as easy as executing:

```
./vendor/bin/baleen migrate
```

By default it will migrate `up` to the latest available version.

If you'd like to see a log instead of the progress-bar then just add the `--no-progress` option to the migrate command above.

Documentation
-------------

[](#documentation)

Documentation can be found either in the `./docs` folder or compiled and online at Read The Docs:

License
-------

[](#license)

Licensed under MIT - for more details please refer to the [LICENSE](https://github.com/baleen/cli/blob/master/LICENSE)file at the root directory.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 97.2% 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 ~13 days

Total

7

Last Release

3874d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f00ae1c2b13428075ab880d5fec7e857f1e9446cb401dc6097ec947a81122ec5?d=identicon)[gabriel.somoza](/maintainers/gabriel.somoza)

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

---

Top Contributors

[![gsomoza](https://avatars.githubusercontent.com/u/106219?v=4)](https://github.com/gsomoza "gsomoza (103 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (3 commits)")

---

Tags

climigrationmigrationsbaleen

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/baleen-cli/health.svg)

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

###  Alternatives

[robmorgan/phinx

Phinx makes it ridiculously easy to manage the database migrations for your PHP app.

4.5k46.2M405](/packages/robmorgan-phinx)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[ssch/typo3-rector

Instant fixes for your TYPO3 PHP code by using Rector.

2592.8M263](/packages/ssch-typo3-rector)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)

PHPackages © 2026

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