@rajat-rastogi/maestro 0.1.7 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -0
- package/app/index.html +13 -0
- package/app/out/main/main.js +1805 -0
- package/app/out/preload/preload.js +105 -0
- package/app/out/renderer/assets/addon-canvas-CszGAohT.js +1977 -0
- package/app/out/renderer/assets/addon-fit-DhSl_-7V.js +58 -0
- package/app/out/renderer/assets/index-CGric_Nm.js +12212 -0
- package/app/out/renderer/assets/index-DBLgxEKP.css +437 -0
- package/app/out/renderer/assets/xterm-BgoKG_Sn.js +6076 -0
- package/app/out/renderer/index.html +14 -0
- package/app/package-lock.json +4616 -0
- package/app/package.json +38 -0
- package/dist/agent/install.d.ts +2 -0
- package/dist/agent/install.d.ts.map +1 -0
- package/dist/agent/install.js +392 -0
- package/dist/agent/install.js.map +1 -0
- package/dist/main.js +56 -1
- package/dist/main.js.map +1 -1
- package/package.json +12 -4
package/README.md
CHANGED
|
@@ -137,6 +137,8 @@ One-paragraph description of the goal.
|
|
|
137
137
|
| `-d, --debug` | Enable debug logging | — |
|
|
138
138
|
| `--no-color` | Disable ANSI color output | — |
|
|
139
139
|
| `--plan-tips` | Show plan authoring best practices | — |
|
|
140
|
+
| `--gui` | Open Maestro desktop GUI (Electron app) | — |
|
|
141
|
+
| `--install-agent` | Set up this machine as a Maestro remote agent | — |
|
|
140
142
|
| `--docs` | Open full reference documentation in browser | — |
|
|
141
143
|
| `--config` | Open web UI to view/edit configuration | — |
|
|
142
144
|
| `--reset` | Interactively reset global config to defaults | — |
|
|
@@ -248,6 +250,50 @@ A few key tips (run `maestro --plan-tips` for the full guide):
|
|
|
248
250
|
|
|
249
251
|
---
|
|
250
252
|
|
|
253
|
+
## Desktop GUI
|
|
254
|
+
|
|
255
|
+
Maestro includes an Electron-based desktop GUI with a live terminal grid for managing
|
|
256
|
+
AI coding sessions across multiple machines.
|
|
257
|
+
|
|
258
|
+
```sh
|
|
259
|
+
maestro --gui
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
On first run, GUI dependencies (Electron, xterm.js, etc.) are installed automatically.
|
|
263
|
+
|
|
264
|
+
Features:
|
|
265
|
+
- **Terminal grid** — 3-column view with miniature xterm.js previews of all sessions
|
|
266
|
+
- **Fullscreen overlay** — click any tile for a full interactive terminal
|
|
267
|
+
- **Session state tracking** — real-time Working / Waiting / Idle / Input Required badges
|
|
268
|
+
- **Machine management** — add remote dev boxes, monitor online status
|
|
269
|
+
- **Create Terminal wizard** — launch Claude or Copilot sessions on any machine
|
|
270
|
+
|
|
271
|
+
---
|
|
272
|
+
|
|
273
|
+
## Remote Agent
|
|
274
|
+
|
|
275
|
+
Run AI coding sessions on remote machines (e.g. Azure Dev Boxes) from your local Maestro GUI.
|
|
276
|
+
|
|
277
|
+
### Setup (one-time, on the remote machine)
|
|
278
|
+
|
|
279
|
+
Open **PowerShell as Administrator** on the remote machine and run:
|
|
280
|
+
|
|
281
|
+
```sh
|
|
282
|
+
npm install -g @rajat-rastogi/maestro
|
|
283
|
+
maestro --install-agent
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
The setup wizard handles everything:
|
|
287
|
+
1. Installs devtunnel (Microsoft Dev Tunnels)
|
|
288
|
+
2. Creates a tunnel with port forwarding
|
|
289
|
+
3. Installs the agent (WebSocket server + PTY management)
|
|
290
|
+
4. Deploys Claude Code hooks for session state tracking
|
|
291
|
+
5. Registers a Scheduled Task for auto-start on login
|
|
292
|
+
|
|
293
|
+
After setup, enter the Tunnel ID in Maestro's Machines view and click **Save & Ping**.
|
|
294
|
+
|
|
295
|
+
---
|
|
296
|
+
|
|
251
297
|
## --docs
|
|
252
298
|
|
|
253
299
|
```sh
|
package/app/index.html
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
|
+
<meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; connect-src http://localhost:*" />
|
|
7
|
+
<title>Maestro</title>
|
|
8
|
+
</head>
|
|
9
|
+
<body>
|
|
10
|
+
<div id="root"></div>
|
|
11
|
+
<script type="module" src="/src/main.tsx"></script>
|
|
12
|
+
</body>
|
|
13
|
+
</html>
|