tldr/pages/common/uv-version.md

uv version

Read or update a project's version. More information: https://docs.astral.sh/uv/reference/cli/#uv-version.

• Display the current project version:

uv version

• Set the project version to a specific value:

uv version {{1.2.3}}

• Bump the project version using semantic versioning:

uv version --bump {{major|minor|patch}}

• Preview version changes without writing to pyproject.toml:

uv version --bump {{patch}} --dry-run

• Update version for a specific package in a workspace:

uv version --package {{package_name}} {{1.2.3}}

• Display version in JSON format:

uv version --output-format json