uv Workflow

Use uv as the entrypoint for Python execution and standalone script management.

Core Rules

• Do not run python or python3 as the shell entrypoint.
• Translate direct Python commands into the closest uv form before running them.
• python inside uv run ... is acceptable because uv controls interpreter selection and environment setup.
• When sandboxed or when cache writes may fail, set UV_CACHE_DIR to a writable temporary directory before running uv.
• For standalone PEP 723 scripts, let uv manage inline metadata. Do not hand-edit metadata blocks.

Command Map