hpbxxtr / composer-upgrade-interactive

v0.4.0 2026-08-25 12:29 UTC

Requires

• php: ^8.3
• composer-plugin-api: ^2.0
• laravel/prompts: 0.3.23

Requires (Dev)

• brnshkr/config: dev-php83
• composer/composer: 2.10.2
• friendsofphp/php-cs-fixer: 3.95.21
• kubawerlos/php-cs-fixer-custom-fixers: 3.37.2
• mockery/mockery: 1.6.15
• pestphp/pest: 4.7.8
• pestphp/pest-plugin-arch: 4.0.2
• phpstan/extension-installer: 1.4.3
• phpstan/phpstan: 2.2.9
• phpstan/phpstan-deprecation-rules: 2.0.5
• phpstan/phpstan-doctrine: 2.0.28
• phpstan/phpstan-phpunit: 2.0.18
• phpstan/phpstan-strict-rules: 2.0.12
• phpstan/phpstan-symfony: 2.0.20
• phpstan/phpstan-webmozart-assert: 2.0.0
• rector/rector: 2.6.1
• symfony/finder: 7.4.17
• symplify/phpstan-rules: 14.10.0
• ticketswap/phpstan-error-formatter: 1.3.0
• tomasvotruba/type-coverage: 2.2.0

MIT

• Hagen Pommer

• php
• cli
• composer
• semver
• update
• dependencies
• interactive
• upgrade
• packagist
• composer-plugin
• outdated
• yarn
• tui
• laravel-prompts

Published on Packagist.org on 2026-08-25 12:39 UTC

README

📖 Read the documentation

An interactive TUI for selectively upgrading Composer dependencies

yarn upgrade-interactive for PHP!

✨ Features

• Patch / minor / major columns per package — choose exactly how far to upgrade each one
• Full version picker — press v on any cell to browse all available stable versions in an inline multi-column list and pin an exact release
• Live compatibility checking — conflicting versions are marked with ! as you navigate; the footer explains which dependency chain is broken and whether it originates from the current upgrade selection or from an already-installed package
• Minimum release age — gate out releases published minutes ago, project-wide or per run
• require and require-dev sections rendered separately
• Abandoned package warnings with replacement suggestions
• Comparison and release URLs in the footer for whichever bump type or version is focused (GitHub, GitLab, Packagist)
• Full keyboard navigation — arrow keys, vim (hjkl), and Emacs (Ctrl+P/N/B/F) bindings

📋 Requirements

• PHP 8.3+
• Composer 2.x

📦 Installation

composer global require hpbxxtr/composer-upgrade-interactive

Or as a project dev dependency:

composer require --dev hpbxxtr/composer-upgrade-interactive

Trust prompt — Composer will ask you to allow the plugin to execute code. Answer y to enable it:

Do you trust "hpbxxtr/composer-upgrade-interactive" to execute code and wish to enable it now?
(writes "allow-plugins" to composer.json) [y,n,d,?] y

🚀 Usage

composer h:ui

Aliases: composer hpbxxtr:upgrade-interactive · composer upgrade-interactive

Navigate to a package, move across the patch/minor/major columns with the arrow keys, press space to select the latest version for that bump level, or press v to open an inline picker and choose any specific stable release. Press enter to confirm and apply.

📖 Documentation

Full docs live at hpbxxtr.github.io/composer-upgrade-interactive:

• Installation · Usage
• Minimum release age — cooldown before a fresh release may be selected
• Key bindings — normal mode, version picker, age input
• How it works — resolution, conflict detection, apply
• CLI reference · Configuration reference

The site is built with VitePress from docs/ and deployed to GitHub Pages on release. To preview it locally:

make docs-dev

📄 License

MIT — see LICENSE.