Use conda workspaces

Register the project

Add the manifest directory as a Python project in the Python Environments view. Conda Code does not treat every matching file in the VS Code window as a project.

Supported candidate names are:

• conda.toml

• pixi.toml

• pyproject.toml

Conda Code validates the candidate with conda workspace info --json. A matching filename alone is not enough.

Run a declared task

Save the task in the manifest. Select the Conda Code workspace environment that should run it, then run Tasks: Run Task from the Command Palette. Select the task listed under the conda-workspaces source.

Conda Code asks conda-workspaces to list the tasks from the selected manifest and delegates the selected task to conda task. When the selected environment belongs to that manifest, Conda Code passes its workspace environment name. Otherwise conda-workspaces applies the task’s declared environment or the workspace default.

Conda Code does not parse or edit task definitions. This integration does not add task arguments. Put fixed options in the task definition or use conda task directly when arguments are required.

See the conda-workspaces task documentation for task definition syntax.

Install a declared environment

Run Python Envs: Create Environment for the project. If the workspace has one uninstalled environment, Conda Code installs it. If it has several, select one from the prompt.

For an environment backed by zero or one feature, Quick Create adds Python when the selected declaration does not already contain it. Adding Python or other creation packages is refused for an environment composed from multiple features. Edit the manifest to choose a feature, then install the environment.

Add conda dependencies

Use Manage Packages to add a dependency. Conda Code records the dependency through conda workspace add when the environment uses zero or one feature.

For an environment composed from multiple features, edit the manifest to choose the correct feature explicitly:

conda workspace add --feature dev -- pytest

Then run Conda Code: Refresh Environments.

Remove or upgrade a workspace dependency

Edit the manifest directly, run the appropriate conda workspace command, then refresh Conda Code. Package removal and package upgrade are not exposed through the Python Environments package operation because those operations need manifest-specific choices.

Clean an installed environment

Use Delete Environment. Conda Code runs conda workspace clean for the declared environment. It does not remove the declaration from the manifest.