Maestro YAML autocomplete, validation & snippets for Visual Studio Code.
Features
Language Support: Full language support for Maestro flow files (.maestro.yaml, .maestro.yml)
Code Snippets: Quick snippets for common Maestro actions
ta → tapOn
av → assertVisible
la → launchApp
it → inputText
sc → scroll
sw → swipe
ci → clearInput
et → eraseText
anv → assertNotVisible
lpo → longPressOn
pk → pressKey
hk → hideKeyboard
wfv → waitForVisible
wfav → waitForAnimationToEnd
rs → runScript
rf → runFlow
rc → runCommand
ts → takeScreenshot
ol → openLink
ctf → copyTextFrom
pt → pasteText
es → evalScript
cond → conditional
rep → repeat
ext → extendState
Supported Commands: All Maestro commands with autocomplete and hover documentation
Interactions:
tapOn
longPressOn
swipe
scroll
scrollUntilVisible
scrollToIndex
scrollUntil
Input:
inputText
clearInput
eraseText
pressKey
hideKeyboard
pasteText
Assertions:
assertVisible
assertNotVisible
assertTrue
assertFalse
assertThat
Navigation:
launchApp
back
stopApp
openLink
Waiting:
waitForVisible
waitForNotVisible
waitForAnimationToEnd
Flow Control:
conditional
repeat
runFlow
Scripting:
runScript
evalScript
runCommand
State & Data:
extendState
copyTextFrom
Utilities:
takeScreenshot
Flow Properties:
appId
name
description
tags
env
Hover Documentation: Hover over any Maestro action to see detailed documentation and examples
Schema Validation: JSON schema validation for Maestro YAML files with autocomplete support
IntelliSense: Smart autocomplete for all Maestro actions and their properties
Why .maestro.yaml?
This extension uses the .maestro.yaml and .maestro.yml file extensions (instead of generic .yaml or .yml) for important reasons:
Best Practice: Restrict to Maestro Files Only
Prevents Extension Conflicts: By using .maestro.yaml, we ensure that this extension only activates for Maestro-specific files, avoiding interference with other YAML-based tools and configurations (Docker Compose, Kubernetes, CI/CD configs, etc.)
Avoids Hijacking All YAML Files: Using generic .yaml or .yml extensions would cause this extension to activate for all YAML files in your workspace, potentially:
Overriding language modes for non-Maestro YAML files
Providing incorrect autocomplete suggestions
Showing irrelevant hover documentation
Causing schema validation conflicts
Clear File Identification: The .maestro.yaml extension makes it immediately clear that a file contains Maestro flow definitions, improving code organization and developer experience.
Industry Standard: Following the naming convention recommended by the Maestro community ensures compatibility and consistency across projects and tools.
Supported File Extensions
.maestro.yaml - Recommended for Maestro flow files
.maestro.yml - Alternative short extension
Requirements
No additional requirements. This extension works out of the box with VS Code.
Usage
Open any .maestro.yaml, .maestro.yml, or .flow file
Start typing to see autocomplete suggestions
Use snippets by typing their shortcuts (e.g., ta for tapOn)
Hover over any action to see documentation
Get validation errors for invalid YAML structure
Extension Settings
This extension does not add any VS Code settings.
Known Issues
None at this time.
Release Notes
0.0.8
Fixed: Autocomplete now works when language mode is set to "YAML" (no need to manually switch)
Changed: Maestro files (.maestro.yaml, .maestro.yml, .flow) now always display as "YAML" in the language selector
Improved: Removed custom "maestro" language registration - all files are now treated as YAML with Maestro-specific features
Fixed: Completion provider and hover documentation now work seamlessly regardless of language mode selection
