dev-desktop-sandbox

Skill do uruchamiania wielu instancji desktopowych (Electron) równolegle, każda z własnym tymczasowym katalogiem MUX_ROOT i wolnymi portami. Automatycznie konfiguruje środowisko, kopiuje pliki konfiguracyjne (providers.jsonc, config.json), uruchamia serwer Vite na przydzielonym porcie, a następnie startuje Electrona z prawidłowymi zmiennymi środowiskowymi. Idealne do pracy z wieloma gałęziami git lub testowania równoczesnych instancji bez konfliktów portów i stanu.

1. Upewnij się, że masz zainstalowany projekt mux z Makefile'em zawierającym cele make dev i make build-static. Skill wymaga również zainstalowanego Node.js, Vite i Electrona.

2. Uruchom podstawową komendę make dev-desktop-sandbox w katalogu projektu. Skill automatycznie utworzy tymczasowy katalog MUX_ROOT, skopiuje pliki konfiguracyjne (providers.jsonc i config.json, jeśli istnieją), wybierze wolne porty dla serwera Vite i debugowania, a następnie uruchomi make dev z tymi parametrami.

3. Czekaj, aż serwer Vite będzie dostępny. Skill monitoruje port i automatycznie przechodzi do następnego kroku, gdy serwer odpowiada.

4. Skill uruchomi make build-static, aby przygotować pliki statyczne (dist/splash.html) wymagane przez Electrona.

5. Electron zostanie uruchomiony z przydzielonymi portami i zmienną CMUX_ALLOW_MULTIPLE_INSTANCES=1, co pozwala na równoczesne uruchamianie wielu instancji. Domyślnie serwer API używa portu 0 (losowy), aby uniknąć konfliktów.

6. Aby dostosować zachowanie, użyj flagi DEV_DESKTOP_SANDBOX_ARGS. Na przykład make dev-desktop-sandbox DEV_DESKTOP_SANDBOX_ARGS="--clean-providers" pomija kopiowanie providers.jsonc, lub --clean-projects usuwa projekty z config.json, zachowując resztę konfiguracji.