PHPackages leviy/release-tool - 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. leviy/release-tool ActiveLibrary[CLI & Console](/categories/cli) leviy/release-tool ================== Command line tool for releasing new versions of a project v3.0.1(1y ago)497272[4 issues](https://github.com/leviy/release-tool/issues)[2 PRs](https://github.com/leviy/release-tool/pulls)MITPHPPHP ^8.3CI passing Since May 30Pushed 3w ago6 watchersCompare [ Source](https://github.com/leviy/release-tool)[ Packagist](https://packagist.org/packages/leviy/release-tool)[ RSS](/packages/leviy-release-tool/feed)WikiDiscussions master Synced 3d ago READMEChangelog (10)Dependencies (13)Versions (19)Used By (0) [![Leviy logo](docs/logo.svg)](docs/logo.svg) Release Tool ============ [](#release-tool) Inspired by [Liip RMT](https://github.com/liip/RMT), this release tool helps you to automate the release of new versions of your software. It is written in PHP but can be used for any type of project, as long as you have PHP installed on your machine. [![Test](https://github.com/leviy/release-tool/workflows/Test/badge.svg)](https://github.com/leviy/release-tool/actions?query=workflow%3ATest)[![License](https://camo.githubusercontent.com/90e0ff5ac9320bb38aac8553e122cb3786e637152d6238e7ab347c3d1f5aed31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c657669792f72656c656173652d746f6f6c2e737667)](https://github.com/leviy/release-tool/blob/master/LICENSE.txt)[![GitHub release](https://camo.githubusercontent.com/5533c4627aefebebe9330f27cfbb2d3da5e9fa44de00e10eb595c167ff62370f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6c657669792f72656c656173652d746f6f6c2e737667)](https://github.com/leviy/release-tool/releases/latest)[![Required PHP version](https://camo.githubusercontent.com/b3719443e805c8a6bccb4eec88447b910800818ff4237f2bbb1f77b7c4f27551/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6c657669792f72656c656173652d746f6f6c2e737667)](https://github.com/leviy/release-tool/blob/master/composer.json) Features -------- [](#features) - Determines the next version number based on [semantic versioning](https://semver.org/) - Creates an annotated Git tag and pushes it to the remote repository - Creates a GitHub release with the name of the release and a changelog with changes since the previous version - Supports pre-release (alpha/beta/rc) versions Installation ------------ [](#installation) ### Phar (recommended) [](#phar-recommended) The recommended method of installing this package is using a phar file. This is because installing using Composer can possibly cause dependency conflicts. You can download the most recent phar from the [Github Releases](https://github.com/leviy/release-tool/releases/latest) page. Global installation (linux) --------------------------- [](#global-installation-linux) Move the downloaded `release-tool.phar` file into your PATH (e.g. `~/bin/release-tool`). Make sure to set the file to executable permissions (e.g. `chmod 775 release-tool`). ### Composer [](#composer) Alternatively, you can install this package using [Composer](https://getcomposer.org/): ``` composer require --dev leviy/release-tool ``` Configuration ------------- [](#configuration) ### GitHub personal access token [](#github-personal-access-token) This tool requires a personal access token with `repo` scope to create GitHub releases. Create one [here](https://github.com/settings/tokens/new?scopes=repo&description=Leviy+Release+Tool)and store it in `.release-tool/auth.yml` in your home folder (`~` on Linux, user folder on Windows): ``` credentials: github: token: ``` Usage ----- [](#usage) > Note: these usage instructions assume that you have downloaded the `release-tool.phar` file to your project directory. If you have installed it in a different location, update the commands accordingly. If you have installed the tool as a Composer dependency, use `vendor/bin/release` instead. ### Releasing a new version [](#releasing-a-new-version) Use `release-tool.phar release ` to release a version. For example: ``` release-tool.phar release 1.0.0 ``` This will release version 1.0.0. By default, this will create a prefixed, annotated Git tag, in this case `v1.0.0`. #### Automatically generating a version number [](#automatically-generating-a-version-number) After tagging a first version, you can let the tool calculate the new version number for you based on the current version and a number of questions. To do so, omit the version from the previous command: ``` release-tool.phar release ``` #### Pre-release versions [](#pre-release-versions) If you want to create a pre-release (alpha/beta/rc) version, run: ``` release-tool.phar release --pre-release ``` ### Other commands [](#other-commands) Run `release-tool.phar list` to see a list of available commands. Updating the release tool ------------------------- [](#updating-the-release-tool) The following command will update the release tool to the latest version: ``` release-tool.phar self-update ``` ### Health Score 54 — FairBetter than 97% of packages Maintenance68 Regular maintenance activity Popularity26 Limited adoption so far Community22 Small or concentrated contributor base Maturity87 Battle-tested with a long release history Bus Factor1 Top contributor holds 70.9% 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 ~168 days Recently: every ~309 days Total 15 Last Release 549d ago Major Versions v1.4.1 → v2.0.02023-09-06 v2.0.0 → v3.0.02024-06-04 PHP version history (5 changes)v1.0.0PHP ^7.1 v1.3.3PHP ^7.2 v1.4.1PHP ^7.3||^8.0 v2.0.0PHP ^7.4 || ^8.0, <8.2 v3.0.0PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/35339329?v=4)[Leviy](/maintainers/leviy)[@leviy](https://github.com/leviy) ![](https://avatars.githubusercontent.com/u/41617?v=4)[Dennis Coorn](/maintainers/denniscoorn)[@denniscoorn](https://github.com/denniscoorn) ![](https://avatars.githubusercontent.com/u/888361?v=4)[Bas Matthee](/maintainers/BasMatthee)[@BasMatthee](https://github.com/BasMatthee) --- Top Contributors [![nicwortel](https://avatars.githubusercontent.com/u/1055691?v=4)](https://github.com/nicwortel "nicwortel (139 commits)")[![VSlokker](https://avatars.githubusercontent.com/u/36398947?v=4)](https://github.com/VSlokker "VSlokker (13 commits)")[![christiaan](https://avatars.githubusercontent.com/u/118490?v=4)](https://github.com/christiaan "christiaan (12 commits)")[![josephineb](https://avatars.githubusercontent.com/u/11058783?v=4)](https://github.com/josephineb "josephineb (10 commits)")[![tlsvda](https://avatars.githubusercontent.com/u/32871631?v=4)](https://github.com/tlsvda "tlsvda (8 commits)")[![denniscoorn](https://avatars.githubusercontent.com/u/41617?v=4)](https://github.com/denniscoorn "denniscoorn (5 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![Skopea](https://avatars.githubusercontent.com/u/48245975?v=4)](https://github.com/Skopea "Skopea (3 commits)")[![rodicodi](https://avatars.githubusercontent.com/u/34191525?v=4)](https://github.com/rodicodi "rodicodi (2 commits)")[![kayjoosten](https://avatars.githubusercontent.com/u/47044428?v=4)](https://github.com/kayjoosten "kayjoosten (1 commits)") --- Tags changelog-generatorrelease-automationrelease-managementsemantic-versioning ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/leviy-release-tool/health.svg) ``` [![Health](https://phpackages.com/badges/leviy-release-tool/health.svg)](https://phpackages.com/packages/leviy-release-tool) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[crunzphp/crunz Schedule your tasks right from the code. 2292.0M6](/packages/crunzphp-crunz)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[phpcr/phpcr-shell Shell for PHPCR 721.3M8](/packages/phpcr-phpcr-shell) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)