Quickstart

The extension maps VS Code commands to uv commands, allowing you to access them through the Command Palette.

Some commands require input; you can provide arguments and options that will be passed to uv. Dismissing the input box, for example with Esc, cancels the command.

For example, if you provide an input like --package myproject to the init command, the executed uv command would look like this:

/path/to/uv init --directory /project/root --python=3.12 --package myproject

As you can see, the extension may add some options automatically, but you can always override them by providing the same option with a different value.

See the detailed list of commands, along with their descriptions and default behavior, here.

Scripts Supports

For some commands that support the --script option, the extension will automatically add it if the currently active editor is a PEP 723–compatible script.

This improves the user experience by allowing a single command—for example, adding a dependency—to work contextually: if a script is open, the dependency is added to it; otherwise, it’s added to the project dependencies.

NOTE

You can override it just like any other option set by the extension.