docs/reference/cli/pixi/workspace/platform/edit.md
Edit an existing workspace platform's subdir and/or virtual packages
--8<-- "docs/reference/cli/pixi/workspace/platform/edit_extender:description"
pixi workspace platform edit [OPTIONS] <NAME> [__NAME[=VERSION[=BUILD]]]...
<NAME></a>
: Name of the platform to editrequired: true
<__NAME[=VERSION[=BUILD]]></a>
: Raw virtual-package specs (__name[=version[=build_string]]) to declare or update on this platform. Use the friendly flags (--cuda, --archspec, ...) for virtual packages that have one; this trailing positional list is the escape hatch for everything else, mirroring the __name = "..." raw keys accepted in pixi.tomlMay be provided more than once.
--subdir <SUBDIR></a>
: Set a new conda subdir for this platform--cuda <VERSION></a>
: Declare a __cuda virtual package at the given version, e.g. 12.0. Valid on any subdir--cuda-arch <VERSION></a>
: Declare a __cuda_arch virtual package (GPU compute capability) at the given version, e.g. 8.6. Requires --cuda (or an existing __cuda), matching the conda CEP coupling. Serialized as cuda = { driver, arch }--archspec <ARCH></a>
: Declare a __archspec virtual package with the given microarchitecture string, e.g. x86_64_v3. Valid on any subdir--glibc <VERSION></a>
: Declare a __glibc virtual package at the given version, e.g. 2.28. Only valid on linux subdirs--linux <VERSION></a>
: Declare a __linux virtual package at the given kernel version, e.g. 5.10. Only valid on linux subdirs--macos <VERSION></a>
: Declare a __osx virtual package at the given macOS version, e.g. 14.0. Only valid on osx subdirsaliases: osx
--windows <VERSION></a>
: Declare a __win virtual package at the given Windows version, e.g. 10. Only valid on win subdirs--remove-virtual-package <NAME></a>
: Remove the named virtual package from this platform. Can be repeatedMay be provided more than once.
--clear-virtual-packages</a>
: Clear all virtual packages before applying any add/upsert operations--no-install</a>
: Don't update the environment, only refresh the lock-fileenv: PIXI_NO_INSTALL
--8<-- "docs/reference/cli/pixi/workspace/platform/edit_extender:example"