Development

Common commands

npm install
npm run typecheck
npm run typecheck:ui
npm test
npm run build:ui
npm run smoke
npm run dev:platform

Use npm run dev for the orchestrator runtime and npm run dev:platform for the API plus Vite UI. The runtime script under scripts/maestro-runtime.ps1 adds PID, log, health and restart handling on Windows.

Working safely

Use a dedicated branch, keep .env.local and .maestro/ out of commits, and never use a developer credential or absolute machine path in a fixture. Changes to provider subprocesses, task state, shutdown, Git delivery and Chat permissions need regression tests.

Desktop build

npm run build:desktop compiles the app; npm run release:win builds the Windows installer. Native dependencies must be rebuilt for Electron. Validate the installer on a clean machine rather than assuming the build machine’s provider sessions are included.