diff --git a/docs/drivers/kosmickrisp.rst b/docs/drivers/kosmickrisp.rst
index 85967093bfb..39db4c03a05 100644
--- a/docs/drivers/kosmickrisp.rst
+++ b/docs/drivers/kosmickrisp.rst
@@ -78,6 +78,16 @@ used to create a debug build:
 
    meson setup <path/to/mesa> --buildtype=debug -Dplatforms=macos -Dvulkan-drivers=kosmickrisp -Dgallium-drivers= -Dopengl=false -Dzstd=disabled
 
+Environment variables
+*********************
+
+KosmicKrisp specific environment variables:
+
+- ``MESA_KK_DEBUG``: Set to ``msl`` to log all generated Metal Shading Language (MSL) shaders.
+- ``MESA_KK_GPU_CAPTURE``: Starts Metal capture at device create and ends it at device destroy. Set to ``1`` to activate.
+- ``MESA_KK_GPU_CAPTURE_DIRECTORY``: Metal capture will be saved to the specified directory. Defaults to Xcode if no path is provided.
+- ``MESA_KK_DISABLE_WORKAROUNDS``: Provide ``all`` to disable all workarounds. Otherwise, provide a comma separated list to disable wanted workarounds e.g. ``1,3,4`` to disable workaround 1, 3 and 4.
+
 Metal workarounds
 *****************