README

Upgrade your composer.json dependencies to the latest versions, ignoring specified version constraints.

Features

🔍 Check for updates beyond your version constraints
🎨 Color-coded output (red=major, cyan=minor, green=patch)
🖱️ Interactive mode to select which packages to update
🎯 Filter packages by name pattern
📦 Supports both require and require-dev dependencies

Installation

Install globally to use composer check-updates or composer ccu from any project:

composer global require beardcoder/composer-check-updates

Usage

Check for updates

# In any project directory with composer.json
composer check-updates

# Or use the alias
composer ccu

Example output:

Checking 15 packages...

Major Upgrades
  symfony/console              ^5.4    →  ^7.0
  doctrine/orm                 ^2.14   →  ^3.0

Minor Upgrades
  monolog/monolog              ^3.4    →  ^3.5

Patch Updates
  guzzlehttp/guzzle            ^7.8.0  →  ^7.8.1

Run composer ccu -u to upgrade composer.json
Run composer ccu -i for interactive mode

Update composer.json

# Update all packages to latest versions
composer ccu -u

# Then install the new versions
composer update

Interactive Mode

Choose which packages to update interactively:

composer ccu -i

Use arrow keys to navigate, Space to toggle selection, Enter to confirm.

Filter Packages

# Only check symfony packages
composer ccu --filter "symfony/*"

# Check multiple patterns
composer ccu --filter "symfony/*" --filter "doctrine/*"

# Exclude packages
composer ccu --reject "phpunit/*"

# Only dev dependencies
composer ccu --dev-only

# Only production dependencies
composer ccu --prod-only

Limit Update Types

# Only show minor and patch updates (skip major)
composer ccu --minor-only

# Only show patch updates
composer ccu --patch-only

Target Version

Control which version to upgrade to:

# Upgrade to latest version (default)
composer ccu --target latest

# Only upgrade to latest minor version (no major upgrades)
composer ccu --target minor

# Only upgrade to latest patch version (no minor/major upgrades)
composer ccu --target patch

# Short form
composer ccu -t minor

JSON Output

composer ccu --json

Specify Working Directory

composer ccu -d /path/to/project

Options

Option	Alias	Description
`--upgrade`	`-u`	Update composer.json with new versions
`--interactive`	`-i`	Interactive mode to select packages
`--filter`	`-f`	Filter packages by name (supports wildcards)
`--reject`	`-x`	Exclude packages by name (supports wildcards)
`--target`	`-t`	Target version: latest, minor, patch (default: latest)
`--dev-only`		Only check dev dependencies
`--prod-only`		Only check production dependencies
`--minor-only`		Only show minor and patch updates
`--patch-only`		Only show patch updates
`--json`		Output results as JSON
`--working-dir`	`-d`	Use the given directory as working directory

Color Legend

Red: Major upgrade (breaking changes possible)
Cyan: Minor upgrade (new features, backwards compatible)
Green: Patch update (bug fixes)

License

MIT

beardcoder / composer-check-updates

Maintainers

Details