pi-uv

A pi extension that auto-rewrites Python commands to execute inside a uv-managed virtual environment.

How it works

When you run Python commands via the bash tool, pi-uv intercepts the tool call and prepends uv run --project <project> so that:

• Commands run inside the correct project virtual environment
• Dependencies are resolved from uv.lock rather than the system Python
• No manual .venv activation needed

Project root detection

pi-uv automatically detects the uv project root using three strategies (in order):

1. From the command argument path — python3 project-a/main.py → detects project project-a/
2. Walk up from CWD — same algorithm as uv itself
3. Scan CWD's immediate subdirectories — catches monorepo-style layouts

Once detected, it rewrites to uv run --project <root> <command>, which tells uv exactly where the project is without changing the command's working directory.

Installation

# Via npm
pi install npm:pi-uv

# Via git
pi install git:github.com/user/pi-uv

# Local development
pi -e ./extensions/pi-uv.ts

Requirements

• uv in PATH (version 0.4+)
• pi (version 0.x)

How to verify

# From inside a uv-managed project
python3 -c "import fastapi; print(fastapi.__version__)"

# The extension rewrites this to:
#   uv run --project . python3 -c "import fastapi; print(fastapi.__version__)"

License

MIT