From 28451ff2130bb2e9354628075662e9fc8fce52f3 Mon Sep 17 00:00:00 2001
From: Sergei Shevlyagin <sergeis@zillowgroup.com>
Date: Thu, 21 May 2026 07:11:41 -0700
Subject: [PATCH 1/2] docs: add macOS workaround for killed install command

Some macOS shells kill the install command when run via process
substitution. Document the download-then-execute alternative.
---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 55d6c8ec..aca57be0 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,14 @@ _Note: Project configuration files can be re-used in other projects. You find th
 bash <(curl -sL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh)
 ```
 
+> **macOS note:** If the process-substitution form above is killed by the shell (e.g. `zsh: killed bash`), download the script first and then run it:
+>
+> ```bash
+> curl -L https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh -o install.sh
+> chmod +x install.sh
+> ./install.sh
+> ```
+
 <details>
 <summary><strong>Advanced Options</strong> (click to expand)</summary>
 

From a70f4cba90a0907f6a0cf918ae461c2d81fd1adf Mon Sep 17 00:00:00 2001
From: Sergei Shevlyagin <sergeis@zillowgroup.com>
Date: Thu, 21 May 2026 07:12:43 -0700
Subject: [PATCH 2/2] docs: move macOS workaround into Advanced Options

---
 README.md | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index aca57be0..f6730999 100644
--- a/README.md
+++ b/README.md
@@ -131,17 +131,19 @@ _Note: Project configuration files can be re-used in other projects. You find th
 bash <(curl -sL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh)
 ```
 
-> **macOS note:** If the process-substitution form above is killed by the shell (e.g. `zsh: killed bash`), download the script first and then run it:
->
-> ```bash
-> curl -L https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh -o install.sh
-> chmod +x install.sh
-> ./install.sh
-> ```
-
 <details>
 <summary><strong>Advanced Options</strong> (click to expand)</summary>
 
+**macOS workaround if the install command is killed**
+
+If the process-substitution form above is killed by the shell (e.g. `zsh: killed bash`), download the script first and then run it:
+
+```bash
+curl -L https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh -o install.sh
+chmod +x install.sh
+./install.sh
+```
+
 **Global installation with force reinstall**
 
 ```bash