Maestrun for VS Code
Download v1.0.0 · Website · Quick guide · Português
Plan, run, and follow Maestrun tasks inside VS Code.

Version 1.0.0. Real interface with demonstration data; no paid model run is shown.
Install
Install Node.js 24 LTS and an authenticated executor supported by Maestrun.
Install the tested CLI:
npm install --global @maestrun/maestrun@0.1.1-beta.5
Download maestrun-vscode-1.0.0.vsix from the release.
In VS Code, run Extensions: Install from VSIX… and select the file.
Open your project folder and click the Maestrun icon.
Requires VS Code 1.106+ and a trusted workspace. Use Linux, macOS, WSL, or SSH. On Windows, open the project through WSL. Install the CLI and executor in the same environment as your project.
The extension is stable 1.0.0. Its tested CLI is 0.1.1-beta.5, installed separately. See maestrun.com for CLI installation and product information.
Run your first workflow
- Open More → Set up workflow.
- Choose your executor, model, and steps.
- Click Generate plan and describe the work.
- Review the tasks.
- Click Run / resume.
Try an example: run Maestrun: Run example from the Command Palette. Examples use your executor account's usage.
Find what you need
| Action |
Where |
| Follow tasks |
Projects / Tasks in the Secondary Side Bar |
| Inspect a step |
Flowchart → click a stage |
| Compare projects |
All flowcharts |
| Read an error |
Expand the notice → View execution log |
| Remove a configuration or example |
Hover a project → trash icon → confirm |
Illustrated usage guide · Guia em português · Development
Help
- Missing CLI? Open maestrun.com, install it, then click Refresh.
- Hidden panel? Click the Maestrun icon or run Maestrun: Open Maestrun.
- Found a bug? Open an issue with the error and extension/CLI versions. Remove secrets from logs before sharing.
Release notes · Sustainable Use License 1.0