prefix-dev · Shardz4 · Apr 19, 2026 · Apr 19, 2026 · Apr 20, 2026
diff --git a/crates/pixi_cli/src/cli_config.rs b/crates/pixi_cli/src/cli_config.rs
@@ -141,7 +141,7 @@ impl LockFileUpdateConfig {
 #[derive(Parser, Debug, Default, Clone)]
 pub struct NoInstallConfig {
     /// Don't modify the environment, only modify the lock-file.
-    #[arg(long, help_heading = consts::CLAP_UPDATE_OPTIONS)]
+    #[arg(long, env = "PIXI_NO_INSTALL", help_heading = consts::CLAP_UPDATE_OPTIONS)]
     pub no_install: bool,
 }
 

diff --git a/crates/pixi_cli/src/update.rs b/crates/pixi_cli/src/update.rs
@@ -31,7 +31,7 @@ pub struct Args {
 
     /// Don't install the (solve) environments needed for pypi-dependencies
     /// solving.
-    #[arg(long)]
+    #[arg(long, env = "PIXI_NO_INSTALL")]
     pub no_install: bool,
 
     /// Don't actually write the lockfile or update any environment.

diff --git a/crates/pixi_cli/src/workspace/platform.rs b/crates/pixi_cli/src/workspace/platform.rs
@@ -28,7 +28,7 @@ pub struct AddArgs {
 
     /// Don't update the environment, only add changed packages to the
     /// lock-file.
-    #[clap(long)]
+    #[clap(long, env = "PIXI_NO_INSTALL")]
     pub no_install: bool,
 
     /// The name of the feature to add the platform to.
@@ -44,7 +44,7 @@ pub struct RemoveArgs {
 
     /// Don't update the environment, only remove the platform(s) from the
     /// lock-file.
-    #[clap(long)]
+    #[clap(long, env = "PIXI_NO_INSTALL")]
     pub no_install: bool,
 
     /// The name of the feature to remove the platform from.

diff --git a/docs/reference/cli/pixi/add.md b/docs/reference/cli/pixi/add.md
@@ -69,6 +69,7 @@ pixi add [OPTIONS] <SPEC>...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/build.md b/docs/reference/cli/pixi/build.md
@@ -56,6 +56,7 @@ pixi build [OPTIONS]
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/list.md b/docs/reference/cli/pixi/list.md
@@ -45,6 +45,7 @@ pixi list [OPTIONS] [REGEX]
 <br>**env**: `PIXI_LOCKED`
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 
 ## Global Options
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>

diff --git a/docs/reference/cli/pixi/lock.md b/docs/reference/cli/pixi/lock.md
@@ -24,6 +24,7 @@ pixi lock [OPTIONS]
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 
 ## Global Options
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>

diff --git a/docs/reference/cli/pixi/publish.md b/docs/reference/cli/pixi/publish.md
@@ -64,6 +64,7 @@ pixi publish [OPTIONS] --to <TO>
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/remove.md b/docs/reference/cli/pixi/remove.md
@@ -67,6 +67,7 @@ pixi remove [OPTIONS] <SPEC>...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/run.md b/docs/reference/cli/pixi/run.md
@@ -64,6 +64,7 @@ pixi run [OPTIONS] [TASK]...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/shell-hook.md b/docs/reference/cli/pixi/shell-hook.md
@@ -55,6 +55,7 @@ pixi shell-hook [OPTIONS]
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/shell.md b/docs/reference/cli/pixi/shell.md
@@ -50,6 +50,7 @@ pixi shell [OPTIONS]
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/tree.md b/docs/reference/cli/pixi/tree.md
@@ -34,6 +34,7 @@ pixi tree [OPTIONS] [REGEX]
 <br>**env**: `PIXI_LOCKED`
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 
 ## Global Options
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>

diff --git a/docs/reference/cli/pixi/update.md b/docs/reference/cli/pixi/update.md
@@ -21,6 +21,7 @@ pixi update [OPTIONS] [PACKAGES]...
 ## Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't install the (solve) environments needed for pypi-dependencies solving
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---dry-run" href="#arg---dry-run">`--dry-run (-n)`</a>
 :  Don't actually write the lockfile or update any environment
 - <a id="arg---environment" href="#arg---environment">`--environment (-e) <ENVIRONMENTS>`</a>

diff --git a/docs/reference/cli/pixi/upgrade.md b/docs/reference/cli/pixi/upgrade.md
@@ -55,6 +55,7 @@ pixi upgrade [OPTIONS] [PACKAGES]...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/workspace/channel/add.md b/docs/reference/cli/pixi/workspace/channel/add.md
@@ -53,6 +53,7 @@ pixi workspace channel add [OPTIONS] <CHANNEL>...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/workspace/channel/remove.md b/docs/reference/cli/pixi/workspace/channel/remove.md
@@ -53,6 +53,7 @@ pixi workspace channel remove [OPTIONS] <CHANNEL>...
 ## Update Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
 :  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
 <br>**env**: `PIXI_FROZEN`

diff --git a/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md b/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md
@@ -64,6 +64,7 @@ pixi workspace export conda-explicit-spec [OPTIONS] <OUTPUT_DIR>
 <br>**env**: `PIXI_LOCKED`
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't modify the environment, only modify the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 
 ## Global Options
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>

diff --git a/docs/reference/cli/pixi/workspace/platform/add.md b/docs/reference/cli/pixi/workspace/platform/add.md
@@ -22,6 +22,7 @@ pixi workspace platform add [OPTIONS] <PLATFORM>...
 ## Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't update the environment, only add changed packages to the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The name of the feature to add the platform to
 

diff --git a/docs/reference/cli/pixi/workspace/platform/remove.md b/docs/reference/cli/pixi/workspace/platform/remove.md
@@ -22,6 +22,7 @@ pixi workspace platform remove [OPTIONS] <PLATFORM>...
 ## Options
 - <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
 :  Don't update the environment, only remove the platform(s) from the lock-file
+<br>**env**: `PIXI_NO_INSTALL`
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The name of the feature to remove the platform from
 

diff --git a/docs/workspace/lockfile.md b/docs/workspace/lockfile.md
@@ -55,7 +55,7 @@ You may want to have more control over the interplay between the manifest, the l
 
 - `--frozen`: install the environment as defined in the lock file, doesn't update `pixi.lock` if it isn't up-to-date with [manifest file](../reference/pixi_manifest.md). It can also be controlled by the `PIXI_FROZEN` environment variable (example: `PIXI_FROZEN=true`).
 - `--locked`: only install if the `pixi.lock` is up-to-date with the [manifest file](../reference/pixi_manifest.md). It can also be controlled by the `PIXI_LOCKED` environment variable (example: `PIXI_LOCKED=true`). Conflicts with `--frozen`.
-
+- `--no-install`: don't modify the environment, only modify the lock-file. It can also be controlled by the `PIXI_NO_INSTALL` environment variable (example: `PIXI_NO_INSTALL=true`).
 
 ## Committing your lockfile