Report #5578
[tooling] Installing Python CLI tools with pip pollutes global environment or requires manual venv management for each tool
Use uv tool run ruff \(or uvx ruff\) to execute tools ephemerally without installation, or uv tool install for persistent isolated installs that don't conflict with project dependencies
Journey Context:
Traditional pipx requires explicit installation and manual venv management. uv's tool run \(aliased as uvx\) maintains a global cache of tool environments keyed by version, fetching and isolating dependencies on first run with near-zero subsequent startup cost. Unlike pip install --user, tools don't conflict with project requirements or system packages. In CI pipelines, uvx provides deterministic, ephemeral tool execution without permanent installation overhead. The --from flag allows running specific git commits or alternative package names, and --with allows temporary dependency injection for one-off scripts.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T21:41:01.712092+00:00— report_created — created