# Settings and commands

## Provider IDs

| Role                | ID                        |
| ------------------- | ------------------------- |
| Environment manager | `jezdez.conda-code:conda` |
| Package manager     | `jezdez.conda-code:conda` |

## Conda Code setting

### `conda-code.condaExecutable`

Absolute path or command name for the primary `conda` executable.

- Type: string
- Default: empty
- Scope: machine-overridable

An empty value uses this precedence:

1. `CONDA_EXE`
2. `python.condaPath`
3. `conda` on `PATH`

The primary conda handles creation, workspaces, tasks, and plugin features. It
does not limit regular environment discovery to one installation. Existing
regular environments use the owning root's conda hooks when an owning `conda`
executable is available. Package changes and safe deletion use that executable.

## Related Python Environments settings

| Setting                                       | Conda Code value or use                                    |
| --------------------------------------------- | ---------------------------------------------------------- |
| `python-envs.defaultEnvManager`               | `jezdez.conda-code:conda`                                  |
| `python-envs.defaultPackageManager`           | `jezdez.conda-code:conda`                                  |
| `python-envs.pythonProjects[].envManager`     | Select Conda Code for one project                          |
| `python-envs.pythonProjects[].packageManager` | Select Conda Code packages for one project                 |
| `python-envs.pythonProjects[].path`           | Registered project root used for workspace discovery       |
| `python.condaPath`                            | Fallback `conda` path when the Conda Code setting is empty |

## Commands

### `Conda Code: Refresh Environments`

Command ID: `conda-code.refresh`

Clears the package cache and refreshes regular environments, workspace
environments, and workspace task discovery. The command also expires cached
conda information and forces a background `conda info --json` request. The
current environment list remains available while that request runs.

Conda Code automatically schedules the same background enrichment when an exact
configuration file reported by conda changes. A lightweight cache fingerprint
detects changes to reported files, relevant conda environment inputs, or the
configured executable while VS Code was closed. The 24-hour cache age remains a
fallback for sources conda had not reported. Conda Code also schedules refreshes
when `conda.toml`, `pixi.toml`, `pyproject.toml`, or `conda.lock` changes.

Project creation inputs such as `environment.yml`, `explicit.txt`, and
`conda-lock.yml` are not watched.