This skill should be used when the user needs help with uv CLI commands, including auth (manage authentication), cache (manage uv's cache), pip, python (manage python versions and installations), self (manage the uv executable), tool, add, build, export, format, help, init, lock, publish, remove, run, sync, tree, venv, version. Covers flags, subcommands, usage patterns, and troubleshooting for all 20 uv commands.
Expert command reference for uv v0.9.28.
This skill applies when:
uv commandsuv invocations or errorsuv operationsEnsure uv is installed and available on PATH.
| Command | Description |
|---|
uv add | Add dependencies to the project |
uv auth | Manage authentication |
uv build | Build Python packages into source distributions and wheels |
uv cache | Manage uv's cache |
uv export | Export the project's lockfile to an alternate format |
uv format | Format Python code in the project |
uv help | Display documentation for a command |
uv init | Create a new project |
uv lock | Update the project's lockfile |
uv pip | Manage Python packages with a pip-compatible interface |
uv publish | Upload distributions to an index |
uv python | Manage Python versions and installations |
uv remove | Remove dependencies from the project |
uv run | Run a command or script |
uv self | Manage the uv executable |
uv sync | Update the project's environment |
uv tool | Run and install commands provided by Python packages |
uv tree | Display the project's dependency tree |
uv venv | Create a virtual environment |
uv version | Read or update the project's version |
| Flag | Short | Type | Description |
|---|---|---|---|
--allow-insecure-host | `` | string | Allow insecure connections to a host [env: UV_INSECURE_HOST=] |
--cache-dir | `` | string | Path to the cache directory [env: UV_CACHE_DIR=] |
--color | `` | string | Control the use of color in output [possible values: auto, always, never] |
--config-file | `` | string | The path to a uv.toml file to use for configuration [env: UV_CONFIG_FILE=] |
--directory | `` | string | Change to the given directory prior to running the command [env: UV_WORKING_DIR=] |
--help | -h | bool | Display the concise help for this command |
--managed-python | `` | bool | Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=] |
--native-tls | `` | bool | Whether to load TLS certificates from the platform's native store [env: UV_NATIVE_TLS=] |
--no-cache | -n | string | Avoid reading from or writing to the cache, instead using a temporary directory for the |
--no-config | `` | string | Avoid discovering configuration files (pyproject.toml, uv.toml) [env: UV_NO_CONFIG=] |
--no-managed-python | `` | bool | Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=] |
--no-progress | `` | bool | Hide all progress outputs [env: UV_NO_PROGRESS=] |
--no-python-downloads | `` | bool | Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"] |
--offline | `` | bool | Disable network access [env: UV_OFFLINE=] |
--project | `` | string | Discover a project in the given directory [env: UV_PROJECT=] |
--version | -V | bool | Display the uv version |
add, build, export, format, help, init, lock, publish, remove, run, sync, tree, venv, version
auth, cache, pip, python, self, tool
For complete command documentation including all flags and subcommands:
references/commands.mdreferences/examples.mduv --help or uv <command> --help for inline help--verbose for detailed output during debuggingTo update this plugin after a CLI version change, run the /scan-cli command
or manually execute the crawler and generator.