otty / dotfiles

All tools/uv

uv

An extremely fast Python package and project manager, written in Rust.

Detected by uv, uvx | macOS, Linux, Windows |docs.astral.sh

Sync it uv.toml

Sync rules

What travels, what stays, what never leaves

uv in your home directory Every rule on this page, by file

cache-dir

Each machine keeps its own copy of these.

· ~/.cache/uv/ Exclude

· %LOCALAPPDATA%/uv/cache/ Exclude

· python/ Exclude

· tools/ Exclude

· credentials/credentials.toml Never synced

· %APPDATA%/uv/data/credentials/credentials.toml Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/uv.tomlThe file this page is generated from

id = "uv"

name = "uv"

homepage = "https://docs.astral.sh/uv/"

description = "An extremely fast Python package and project manager, written in Rust."

icon = "SimpleIcons:uv"

detect = ["uv", "uvx"]

# https://docs.astral.sh/uv/concepts/configuration-files/ — "uv will also

# discover uv.toml configuration files in the user- and system-level

# configuration directories, e.g., user-level configuration in

# ~/.config/uv/uv.toml on macOS and Linux, or %APPDATA%\uv\uv.toml on

# Windows." That is `[configHome]` — the XDG configuration directory on macOS

# as well as Linux, so $XDG_CONFIG_HOME moves it and one entry covers Windows

# too. The /etc/uv/uv.toml and %PROGRAMDATA% copies are system-level and out

# of scope; pyproject.toml belongs to the project.

paths = ["[configHome]/uv/uv.toml"]

# https://docs.astral.sh/uv/reference/storage/ gives the cache directory as

# $XDG_CACHE_HOME or $HOME/.cache/uv on macOS and Linux and

# %LOCALAPPDATA%\uv\cache on Windows, and the persistent data directory —

# installed Python versions and `uv tool` environments — as

# $XDG_DATA_HOME or $HOME/.local/share/uv, %APPDATA%\uv\data on Windows. All

# of it is rebuildable machine state. The Unix spellings are `[xdgCache]` and

# `[xdgData]`, the XDG halves of those pairs, and uv reads the variables rather

# than assuming their defaults: crates/uv-dirs/src/lib.rs resolves both through

# `etcetera::base_strategy::choose_base_strategy()`, which is the XDG strategy

# on macOS as well as Linux and looks up $XDG_CACHE_HOME and $XDG_DATA_HOME

# before falling back. `uv cache dir`, `uv python dir` and `uv tool dir` print

# the resolved paths and follow those variables when they are set. (The

# `legacy_*` functions beside them take the native strategy — ~/Library/Caches

# and ~/Library/Application Support — but those are the pre-migration

# directories uv only reads, not ones it fills.) The Windows copies stay

# written out: they sit under \uv\cache and \uv\data rather than at the root of

# the base directory, so no placeholder reaches them.

exclude = [

"[xdgCache]/uv/",

"%LOCALAPPDATA%/uv/cache/",

"[xdgData]/uv/python/",

"[xdgData]/uv/tools/",

]

# https://docs.astral.sh/uv/concepts/authentication/http/, "The uv credentials

# store": "Credentials are stored in a plaintext file in uv's state directory,

# e.g., ~/.local/share/uv/credentials/credentials.toml on Unix." That is the

# data directory above, so it is written as `[xdgData]` for the same reason.

# The Windows spelling is the same relative path under the documented Windows

# data directory (%APPDATA%\uv\data); it is listed so the file is withheld

# there too, since marking one file too many costs nothing and missing one

# leaks a token. ~/.netrc, which uv also reads, belongs to curl's entry.

secret = [

"[xdgData]/uv/credentials/credentials.toml",

"%APPDATA%/uv/data/credentials/credentials.toml",

]

# Read at the start of a uv invocation; nothing holds it open.

side_effect = false

# cache-dir names a directory on this machine's disk — a different volume, a

# different drive letter, a scratch partition that only exists here — so the

# line does not travel, while index-url, python-preference and resolution

# settings do. The file is one base-directory path on every platform, so the

# rule has a single spelling to name.

# The volume is one the user picked, so the line is kept for rebuilding this

# machine rather than dropped, and is applied to no other.

[[machine_lines]]

file = "[configHome]/uv/uv.toml"

match = { key_path = ["cache-dir"] }

scope = "backup"

# No secret_paths inside uv.toml. An index URL can carry an embedded token,

# but the overwhelming majority are public, and `uv auth login` writes to the

# credentials store above rather than into this file — the consumer's own

# content scan is the right layer for the rare inline one.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/uv. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out. None of them splits cache-dir for you — that part is Otty’s own sync, or a template you write by hand.