Airflows DSL for Visual Studio Code Plugin
Modeling tool for Airflows DSL (Domain Specific Language). Extension for VS Code and Cursor that allows modeling, downloading, exporting, and deploying Airflows models.
Description
This extension provides complete support for the Airflows DSL language, including:
- Editor with syntax highlighting for
.airflows files
- Navigation and file explorer integrated in the Airflows panel
- Model download from remote Airflows instance
- Model export as local ZIP files
- Model deployment to Airflows instance
- Validation and autocomplete for the DSL language
- Error message definitions for backend error messages with regex and localized labels
- AI and orchestration modeling for defining AI agents, activity agents, MCP,
ModelOrchestration, and related DSL constructs
- GIS visualization support to configure and validate GisViewer-related DSL elements
- Governance and semantic layer modeling for ontologies (
ontology), semantic layers (semanticLayer), and application–ontology links (semanticLink)
What's new
- Form layout positions and agent options (1.2.4):
position: on groups and tabs, listPosition: on related lists and tabsPosition: on the entity (the tab row) place each block among the fields of its level, on the scale of their order: (1 to 1000). AI agents accept webSearchDisabled, and agent orchestrations accept the strategies the platform writes. Commands and settings follow the VS Code language (English or Spanish).
- Quoted names and safer export (1.2.2): block headers accept quoted names such as
webPackage "airflows-cpi", so the web package keeps its name in the export. Export model and Deploy model stop and list what is wrong when a .airflows file has a syntax error, a function has no path, or a file the model points to (function code, data, web package, agent context) is not in the folder.
- MCP access token (1.2.0): new
addAccessToken flag in the mcp block. Add it when the MCP server needs the user's session token; without it, the token is not sent to that server.
- Default order with several criteria (1.1.0):
defaultOrder <field> { desc nullsLast } can be repeated; the first criterion applies first and the rest break ties. The previous keys (defaultOrderAttribute:, defaultOrderDesc, defaultOrderNullsLast) are still accepted.
- Form data activities (1.1.0):
FORM_QUERY and FORM_WRITE activities inside workflows_process, configured with the entity (the form) and functionVariables (JSON configuration) properties.
- Subworkflows (1.0.15):
SUBWORKFLOW activities inside workflows_process via a subProcess property (the child workflow name).
- Governance (1.0.12): blocks for ontologies (Turtle OWL), semantic layers, and application links.
- Deploy replace mode (1.0.11): optional
airflows.deployReplaceMode setting (see Extension settings).
Features
Intelligent Autocomplete
The editor provides advanced contextual autocomplete:
- Attribute autocomplete: Suggests relevant fields based on context (EntityAttribute, EntityKey, EntityReference, errorMessage, etc.)
- Enum value autocomplete: Suggests valid values for enum types (HumanLanguageType, BarcodeType, EventType, etc.)
- Intelligent filtering: Does not suggest already used fields
- Broad coverage: dozens of attribute fields and multiple enum types
Real-Time Validation
- Syntax validation: Detects syntax errors as you type
- Reference validation: Verifies that references to EntityTab, EntityGroup, etc. exist
- Type validation: Detects invalid tokens (e.g., standalone TEXT without
type:)
- Error message validation: Validates
errorMessage blocks (required regex:, valid name pattern, localized labels)
- Descriptive messages: Clear errors with exact location
File Explorer
The Airflows side panel includes a file explorer that:
- Shows the project structure
- Allows navigation between files and folders
- Opens files when clicking on them
- Shows custom icons for
.airflows files (white in dark theme, black in light theme)
- Automatically updates every 2 seconds to detect external changes
- Automatically refreshes after downloading a model
Extension settings
Configure under Settings → Extensions → Airflows (or edit settings.json):
| Setting |
Purpose |
airflows.instanceUrl |
URL of the Airflows instance |
airflows.username |
Admin-capable user for download/deploy |
airflows.password |
Password for the above user |
airflows.initialValidation |
full (open all .airflows in sequence on load), batched (staggered batches), or off (do not open files; validation still runs when you edit) |
airflows.initialValidationBatchSize |
Batch size when initialValidation is batched |
airflows.initialValidationMaxFiles |
Cap on how many .airflows files to open during initial validation (0 = no limit) |
airflows.deployReplaceMode |
When true, deploy uses replace mode: removes model objects absent from the DSL. Default false (add/update only) |
airflows.deployTimeoutMs |
Maximum time for model download/deploy, in ms. Default 900000 (15 min) |
airflows.insecureSkipTlsVerify |
When true, the instance's TLS certificate is not verified. Only for test environments with self-signed or expired certificates |
Download, deploy, and authentication activity is logged in View → Output → Airflows.
Available Commands
Toolbar entries in the Airflows view include download, deploy, and export. Additional commands are available from the Command Palette:
Download model from Airflows instance
- Downloads the model from the configured remote instance
- Automatically extracts the ZIP in the workspace
- Overwrites existing files
- Requires configuration of instance URL, username, and password
Deploy model to Airflows instance
- Creates a ZIP of the local model
- Uploads it to the remote Airflows instance
- Validates the model before deployment
- Shows detailed error messages if something fails
Export local model as ZIP
- Exports the local model as a ZIP file
- Allows saving it to the desired location
- Useful for creating backups or sharing models
Validate model
- Validates all
.airflows files in the project
- Shows results in the Problems panel
- Useful for verifying the model before deploying
Find references
- Finds all references to a selected element
- Useful for navigating and understanding dependencies
Application Package Generation
Application Package Generation and Export
Allows generating an application package from Airflows DSL files for use on the Airflows platform.
Upload of the Generated Application Package
Allows uploading a generated application package for use and installation on the Airflows platform using the connection settings configured in the plugin.
Explore all the features of the Airflows plugin in Visual Studio Code and enhance your productivity when working with Airflows DSL files!
Troubleshooting and Support
For additional help or to report issues with the Airflows plugin, you can contact the Airflows support team through the following channels:
| |