Add GitHub import, PR workflows, and widget startup fixes

- Add GitHub repo browsing, bundle listing, device/mobile auth, and import-from-GitHub endpoints

- Add PR helpers for generating bundles, localizing repos, and merging repos into apps/* with master runner scripts

- Add Cursor workspace loop (clone/open/push) to close the PR-fix cycle

- Fix widget duplicate-window races with named mutex + consistent cleanup; adjust default widget height

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: nedpearson

.env.example

@@ -17,3 +17,23 @@ LOCAL_NEXUS_PORT_RANGE_END=3999
 
 # Logs
 LOCAL_NEXUS_LOG_DIR=data/logs
+
+# GitHub "mobile auth" (device flow)
+# Create a GitHub OAuth App and set its Client ID here to enable "Connect GitHub (mobile)" in the dashboard.
+LOCAL_NEXUS_GITHUB_OAUTH_CLIENT_ID=
+# Local convenience: auto-open the dashboard in your browser on startup.
+# Defaults to enabled for local runs, disabled on hosted platforms.
+LOCAL_NEXUS_OPEN_BROWSER=true
+
+# Reboot/logon widget behavior (Windows)
+# Wait for internet connectivity before opening the widget (recommended).
+LOCAL_NEXUS_WAIT_FOR_INTERNET=true
+# Max time to wait for internet before proceeding anyway.
+LOCAL_NEXUS_INTERNET_TIMEOUT_SECONDS=90
+# Additional delay at logon to let desktop/network settle.
+LOCAL_NEXUS_WIDGET_START_DELAY_SECONDS=12
+
+# Widget window geometry (pixels)
+LOCAL_NEXUS_WIDGET_WIDTH=780
+LOCAL_NEXUS_WIDGET_HEIGHT=240
+LOCAL_NEXUS_WIDGET_MARGIN=8

README.md

@@ -22,10 +22,36 @@ copy .env.example .env
 python -m local_nexus_controller
 ```
 
+By default, the controller will auto-open the dashboard in your browser on startup.
+To disable that behavior, set `LOCAL_NEXUS_OPEN_BROWSER=false` in your `.env`.
+
 Then open:
 - Dashboard: `http://127.0.0.1:5010`
 - API docs (Swagger): `http://127.0.0.1:5010/docs`
 
+## Show dashboard automatically after reboot (Windows)
+
+If you want the dashboard **visible after reboot/logon**, this repo includes a small “desktop widget” launcher that:
+- starts the server in the background
+- opens the dashboard as a **small app window** in the **bottom-left** of your primary monitor
+
+Enable it:
+
+```powershell
+.\tools\enable_startup.ps1
+```
+
+Disable it:
+
+```powershell
+.\tools\disable_startup.ps1
+```
+
+Notes:
+- Run `.\run.ps1` once first so the `.venv` and dependencies exist.
+- The widget uses Edge/Chrome/Brave (first one found in PATH).
+- To adjust size/position, edit `tools/start_dashboard_widget.ps1` (`$w`, `$h`).
+
 ## Import sample registry (4 services + 2 databases)
 
 ```powershell

local_nexus_controller/__main__.py

@@ -1,9 +1,26 @@
+import os
+import threading
 import uvicorn
+import webbrowser
 
 from local_nexus_controller.settings import settings
 
 
 def main() -> None:
+    if settings.open_browser and os.environ.get("LOCAL_NEXUS_BROWSER_OPENED") != "1":
+        # Prevent multiple opens when uvicorn reload spawns a child process.
+        os.environ["LOCAL_NEXUS_BROWSER_OPENED"] = "1"
+
+        def _open() -> None:
+            host = settings.host
+            # Browsers can't navigate to 0.0.0.0; use loopback for local convenience.
+            if host in {"0.0.0.0", "::"}:
+                host = "127.0.0.1"
+            url = f"http://{host}:{settings.port}/"
+            webbrowser.open(url, new=2)
+
+        threading.Timer(0.75, _open).start()
+
     uvicorn.run(
         "local_nexus_controller.main:app",
         host=settings.host,