Manage installed apps

List, upgrade, and remove the apps pipx manages, then confirm each change.

List apps

$ pipx list

The output shows each package version, its apps, and the environment paths. Narrow or reshape it:

  • pipx list --short prints package names and versions only.

  • pipx list --include-injected also lists packages injected into each environment.

  • pipx list --outdated lists environments with an available upgrade.

  • pipx list --pinned lists pinned environments only.

Upgrade one

$ pipx upgrade black

Add --include-injected to upgrade injected packages alongside the main app. Pass --install to install the package spec when it is missing rather than error.

Verify:

$ pipx list --short

Upgrade all

$ pipx upgrade-all

Use --skip PKG ... to leave named environments untouched, and --include-injected to include injected packages. Pinned environments are skipped; see Pin packages.

Verify:

$ pipx list --outdated

Uninstall one

$ pipx uninstall black

pipx deletes the environment and unlinks its apps and manual pages.

Verify:

$ pipx list --short

Uninstall all

$ pipx uninstall-all

Record what you have first with pipx list --short if you plan to reinstall later.

Verify:

$ pipx list

Reinstall one

Rebuild an environment from its recorded metadata, keeping the same options as the original install. Reach for it after a Python upgrade or to repair a broken environment.

$ pipx reinstall black

Pass --python to rebuild under another interpreter.

Verify:

$ pipx list --short

Reinstall all

$ pipx reinstall-all

Common after installing a new Python version so every app moves to it. Use --python to target a specific interpreter and --skip PKG ... to exclude environments.

Verify:

$ pipx list

Tip

To check environments without changing them, or to repair only the broken ones, see Diagnose and repair environments.