Exit codes

pipx returns 0 on success and 1 on failure. A command that raises an unexpected error, is interrupted, or hits an argument-parsing problem also exits non-zero. The named codes below come from pipx.constants; each maps to one of those two process exit values.

reinstall-all exits with 1 if any environment could not be reinstalled, including when its selected Python interpreter belongs to that environment. With --output json, failed environments appear in errors and only successfully reinstalled environments appear in data.environments.

Code	Name	Meaning
0	EXIT_CODE_OK	Command completed successfully.
0	EXIT_CODE_INSTALL_VENV_EXISTS	Install skipped because the environment already exists; not treated as a failure.
1	EXIT_CODE_INJECT_ERROR	inject failed to install one or more packages.
1	EXIT_CODE_UNINJECT_ERROR	uninject failed to remove one or more packages.
1	EXIT_CODE_LIST_PROBLEM	list found an environment it could not read.
1	EXIT_CODE_UNINSTALL_VENV_NONEXISTENT	uninstall targeted an environment that does not exist.
1	EXIT_CODE_UNINSTALL_ERROR	uninstall failed to remove the environment.
1	EXIT_CODE_REINSTALL_VENV_NONEXISTENT	reinstall targeted an environment that does not exist.
1	EXIT_CODE_REINSTALL_INVALID_PYTHON	reinstall was given a Python interpreter it could not use.
1	EXIT_CODE_SPECIFIED_PYTHON_EXECUTABLE_NOT_FOUND	The interpreter passed to --python was not found.