Usage

Basic Usage

Run ripen in any project directory:

ripen

ripen will:

Detect your package manager (by checking lock files)
Run the outdated check
Display an interactive list of packages that can be updated

Global Packages

To check globally installed packages:

ripen -g

In global mode, ripen scans npm, pnpm, and yarn in parallel and combines the results.

To list every globally installed package — not just outdated ones:

ripen -g -a

Show All Packages

To list every dependency — not just outdated ones:

ripen --all
# or
ripen -a

Up-to-date packages are shown with their current version in green. This is useful for browsing changelogs or using the version picker to downgrade a package.

Keyboard Controls

Key	Action
`↑` `↓`	Navigate through packages
`PgUp` `PgDn`	Scroll a full page
`Tab`	Jump to the next group header
`←` `→`	Collapse / expand a scope sub-group
`Space`	Toggle package selection
`V`	Open version picker for current package
`C`	View changelog / release notes
`Enter`	Copy update command to clipboard & exit
`S`	Open settings
`Esc`	Go back / cancel
`Ctrl+C`	Exit ripen

Selecting Packages

Use the arrow keys to move the cursor and press Space to toggle selection. Selected packages are marked with a filled circle. Press Enter to copy the update command to your clipboard and exit — ripen never runs commands for you.

ripen groups packages by dependency type (dependencies vs devDependencies) and builds one install command per group.

Version Picker

Press V on any package to open the version picker. This fetches all available versions from the npm registry and lets you scroll through them to pick a specific version — not just the latest.

Pre-release versions are filtered out unless they carry a dist-tag.

Changelog Viewer

Press C to view the changelog for the currently highlighted package. ripen fetches release notes from the GitHub Releases API and shows them between your current version and the target version.

This helps you understand what changed before committing to an update.

Clipboard Output

After pressing Enter, ripen copies the update command (or commands, one per dependency group) to your clipboard and exits. Just paste and run it in your terminal.

CLI Options

Flag	Description
`-g`, `--global`	Check global packages
`-a`, `--all`	Show all packages, not just outdated
`--help`	Show help message
`--version`	Show ripen version

Next Steps

Configuration — customize grouping and sorting
Package Managers — learn how detection works