From 0112c4bd8d51aa249e3c34883de1b3da27cb67c6 Mon Sep 17 00:00:00 2001
From: haikdc <haikdecie@gmail.com>
Date: Mon, 30 Mar 2026 02:15:49 -0700
Subject: [PATCH] [Haik]: cleaned up running shell scripts

---
 README.md                                  | 11 +++++++----
 run.sh => run/local.sh                     |  3 ++-
 publish.sh => run/publish.sh               |  5 +++--
 {scripts => run/utils}/build-app.sh        |  0
 {scripts => run/utils}/build-python-env.sh |  0
 5 files changed, 12 insertions(+), 7 deletions(-)
 rename run.sh => run/local.sh (98%)
 rename publish.sh => run/publish.sh (72%)
 rename {scripts => run/utils}/build-app.sh (100%)
 rename {scripts => run/utils}/build-python-env.sh (100%)

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