dev-desktop-sandbox

Installation
SKILL.md

Desktop (Electron) sandbox instances

make dev + make start (Electron) uses MUX_ROOT for persisted state (config, sessions, worktrees, etc.). Running multiple Electron instances against the same mux root is noisy and risky during development.

This skill documents the repo workflow for starting multiple desktop dev instances in parallel (including from different git worktrees) by giving each instance its own temporary MUX_ROOT.

Quick start

make dev-desktop-sandbox

What it does

  • Creates a fresh temporary MUX_ROOT directory
  • Copies these files into the sandbox if present (unless disabled by flags):
    • providers.jsonc (provider config)
    • config.json (project list)
  • Picks free ports:
Related skills
Installs
28
Repository
coder/mux
GitHub Stars
1.7K
First Seen
Feb 28, 2026