dev-desktop-sandbox

Launches isolated Electron sandboxes for concurrent lattice desktop instances.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/latticeHQ/latticeWorkbench --skill dev-desktop-sandbox-latticehq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-desktop-sandbox
Source: https://github.com/latticeHQ/latticeWorkbench/tree/main/.lattice/skills/dev-desktop-sandbox
Command: npx skills add https://github.com/latticeHQ/latticeWorkbench --skill dev-desktop-sandbox-latticehq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run isolated Electron desktop instances without sharing a single lattice root, preventing conflicts between parallel sessions.

Core Features & Use Cases

  • Creates a fresh temporary LATTICE_ROOT for each sandbox.
  • Optionally copies provided config files (providers.jsonc, config.json) into the sandbox when present.
  • Allocates free ports for the Vite devserver and Electron remote debugging.
  • Executes make dev with LATTICE_ROOT and port environment variables to boot the sandboxed instance.
  • Waits for the devserver to become reachable, then runs make build-static to prepare dist for Electron.
  • Launches Electron with isolated environment variables to guarantee multiple concurrent instances.

Quick Start

Run make dev-desktop-sandbox to start a sandboxed Electron desktop instance.

Frequently Asked Questions about dev-desktop-sandbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple isolated Electron desktop instances in parallel?

Launch isolated Electron sandboxes using `make dev-desktop-sandbox` to create a temporary LATTICE_ROOT and assign unique Vite and remote debugging ports, preventing conflicts between parallel lattice desktop instances.

Why do my parallel Electron development sessions conflict with each other?

Parallel sessions conflict by sharing a single lattice root and port. The sandbox resolves this by generating a fresh temporary LATTICE_ROOT and allocating free ports for each concurrent instance.

Does the Electron sandbox support custom provider configurations?

Yes, the sandbox supports custom configurations by optionally copying provided `providers.jsonc` and `config.json` files into the fresh temporary LATTICE_ROOT directory when they are present before execution.

How does the sandbox prepare the Vite devserver for Electron?

The sandbox executes `make dev` with configured environment variables, waits until the Vite devserver becomes reachable, and then runs `make build-static` to prepare the dist output for the Electron instance.

Do I need a Makefile to use the isolated desktop sandbox?

Yes, a Makefile is required because the sandbox relies on the `dev-desktop-sandbox` target and executes `make dev` and `make build-static` commands to manage environment variables and boot the isolated instance.