uv-state

crates/uv-state/ defines the state directory layout: where managed Pythons live, where tool environments live, where resolution caches that survive uv cache clean go.

Key abstractions

• StateBucket — typed buckets: ManagedPython, Tools, Tool, Cache-style fragments.
• StateStore — root directory + per-bucket helpers.

The state directory is ~/.local/share/uv on Linux, ~/Library/Application Support/uv on macOS, and %LOCALAPPDATA%\uv on Windows; overridable via UV_STATE_DIR.

See also

• uv-dirs — root-directory resolution.
• uv-tool, uv-python — heaviest consumers.