diff --git a/.vitepress/data/env.reference.yaml b/.vitepress/data/env.reference.yaml
index 3e10312..0f9fd1c 100644
--- a/.vitepress/data/env.reference.yaml
+++ b/.vitepress/data/env.reference.yaml
@@ -791,6 +791,23 @@ envs:
           spec, so `@version` pins *(`prettier@3.2.5`)* and scoped packages
           *(`@angular/cli`)* are supported.
 
+  pip:
+    name: pip
+    properties:
+      additional_packages:
+        type: string
+        default: null
+        delimiter: " "
+        since: 0.3.1
+        reference: /tools/python
+        example: httpx==0.27.0 rich
+        description: Additional global Python packages installed during startup.
+        longDescription: |
+          Accepts a **space-delimited** package list. Each entry is a full pip
+          spec, so `==` pins *(`httpx==0.27.0`)* and extras *(`rich[jupyter]`)*
+          are supported. For installable CLI tools prefer
+          `WS_UV_ADDITIONAL_TOOLS`.
+
   secrets:
     properties:
       master_key:
@@ -987,6 +1004,23 @@ envs:
         reference: /editor/terminal
         description: Hides the current user in the prompt.
 
+  uv:
+    name: uv
+    properties:
+      additional_tools:
+        type: string
+        default: null
+        delimiter: " "
+        since: 0.3.1
+        reference: /tools/python
+        example: ruff poetry==1.8.0
+        description: Additional global Python CLI tools installed during startup.
+        longDescription: |
+          Accepts a **space-delimited** package list. Each entry is a full uv
+          spec, so `==` pins *(`poetry==1.8.0`)* are supported. Installs global
+          CLI tools only — for importable libraries use
+          `WS_PIP_ADDITIONAL_PACKAGES`.
+
   zsh:
     properties:
       additional_plugins: