diff --git a/README.md b/README.md
index f20bfdbb..a8e151c2 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,7 @@ Download the latest release for macOS from [GitHub Releases](https://github.com/
 ```bash
 git clone https://github.com/openswarm-ai/openswarm.git
 cd openswarm
-bash run.sh
+bash run/local.sh
 ```
 
 This starts the backend (port 8324), frontend (port 3000), and Electron shell together. Once running, set your Anthropic API key in the in-app Settings page.
@@ -197,9 +197,12 @@ electron/
   main.js             Electron main process, auto-updater, Python env management
   scripts/            Build and notarization scripts
 
-scripts/
-  build-app.sh        Desktop app packaging (electron-builder)
-  build-python-env.sh Standalone Python 3.13 environment bundler
+run/
+  utils/
+    build-app.sh        Desktop app packaging (electron-builder)
+    build-python-env.sh Standalone Python 3.13 environment bundler
+  local.sh           Start backend, frontend, and Electron shell
+  publish.sh         Build and deploy to Firebase Hosting
 ```
 
 <br>
diff --git a/run.sh b/run/local.sh
similarity index 98%
rename from run.sh
rename to run/local.sh
index c0520fc9..02a74885 100755
--- a/run.sh
+++ b/run/local.sh
@@ -8,7 +8,8 @@ else
 fi
 chmod +x "$SCRIPT_ABSPATH"
 
-PROJECT_ROOT="$(dirname "$SCRIPT_ABSPATH")"
+RUN_DIR_ROOT="$(dirname "$SCRIPT_ABSPATH")"
+PROJECT_ROOT="$(dirname "$RUN_DIR_ROOT")"
 
 BLUE='\033[0;34m'
 GREEN='\033[0;32m'
diff --git a/publish.sh b/run/publish.sh
similarity index 72%
rename from publish.sh
rename to run/publish.sh
index fccaa935..f9e0584a 100755
--- a/publish.sh
+++ b/run/publish.sh
@@ -8,10 +8,11 @@ else
 fi
 chmod +x "$PUBLISH_ABSPATH"
 
-PROJECT_ROOT="$(dirname "$PUBLISH_ABSPATH")"
+RUN_DIR_ROOT="$(dirname "$PUBLISH_ABSPATH")"
+PROJECT_ROOT="$(dirname "$RUN_DIR_ROOT")"
 cd "$PROJECT_ROOT"
 
 echo "Building and deploying to Firebase Hosting..."
-bash scripts/build-app.sh --publish
+bash run/utils/build-app.sh --publish
 
 cd -
\ No newline at end of file
diff --git a/scripts/build-app.sh b/run/utils/build-app.sh
similarity index 100%
rename from scripts/build-app.sh
rename to run/utils/build-app.sh
diff --git a/scripts/build-python-env.sh b/run/utils/build-python-env.sh
similarity index 100%
rename from scripts/build-python-env.sh
rename to run/utils/build-python-env.sh