mirror of https://github.com/jlengrand/Maestro.git synced 2026-03-10 08:31:19 +00:00

Files

chr1syy aafe0d6a48 fix(windows): stabilize local and SSH execution for wizard and sessions

- Use full agent path (claude.exe) on Windows to avoid shell:true
  which breaks stdin piping for stream-json input mode
- Fix SSH condition to check enabled flag, not just config existence
- Pass sessionSshRemoteConfig through inline wizard to enable remote execution
- Add synopsis SSH inheritance from parent session as backend workaround

Fixes local wizard crashing with exit code 1 and SSH sessions
incorrectly using local paths when SSH was disabled.

2026-01-26 13:01:44 +00:00

2.3 KiB

Raw Blame History

Building and Running on Windows

This guide provides instructions for setting up your environment and running the Maestro application on a Windows machine.

Prerequisites

Before you begin, ensure you have the following installed:

Node.js: Version 22 or later.
Python: Version 3 or later.

Additionally, you will need the Visual Studio Build Tools to compile native Node.js modules used in this project.

Installing Visual Studio Build Tools

Download the Build Tools:
- Go to the Visual Studio Downloads page.
- You may need to log in with a Microsoft account.
- Download the Build Tools for Visual Studio 2022.
Run the Installer:
- When the installer launches, you will be prompted to select workloads.
- Check the box for Desktop development with C++.
- Proceed with the installation.
Verify the Setup:
- After the installation is complete, open a PowerShell terminal in the project root.
- Run npm ci to install dependencies. If you have already run npm install, you can run npx electron-rebuild to rebuild the native modules.

Running the Application in Development Mode

There are two ways to run the application in development mode on Windows: using the provided script or by running the steps manually.

Using the Development Script (Recommended)

The easiest way to start the development environment is to use the dev:win npm script. This script automates the entire process.

Open a PowerShell terminal and run:

npm run dev:win

This will handle all the necessary build steps and launch the application.

Manual Steps

If you encounter issues with the dev:win script or prefer to run the steps manually, follow this procedure.

Build the application:
```
npm run build
```
Start the Vite renderer:
```
npm run dev:renderer
```

Start the Electron main process: Open a new PowerShell terminal and run the following command:

npm run build:prompts; npx tsc -p tsconfig.main.json; $env:NODE_ENV='development'; npx electron .

This will launch the application in development mode with hot-reloading for the renderer.

2.3 KiB Raw Blame History