Stacktape for VS Code

Validation, autocomplete, hover documentation, and CLI commands for Stacktape configuration files.

Stacktape validation, hover docs, and the schema-version code lens in VS Code

Features

Validation — validates your config against the Stacktape schema, and flags $ResourceParam / $CfResourceParam / $Var directives and connectTo entries that reference a resource or variable not defined in the file.
Autocomplete — schema-driven completion, plus completion of your resource/variable names inside directives (e.g. $ResourceParam('…')).
Hover documentation — property descriptions with links to the matching page on docs.stacktape.com, and a preview of what a directive reference points to.
Go to definition — jump from a $ResourceParam / $Var argument or a connectTo entry to where that resource/variable is defined.
CLI commands — run Validate, Preview (diff), and Deploy for the current config without leaving the editor.

File detection

The extension activates for files named *stacktape.yml, *stp.yml, *stacktape.yaml, *stp.yaml (and their .debug. variants). These open as the dedicated Stacktape language, so the extension works alongside the official YAML extension without conflicting on your other YAML files.

Schema resolution

The config schema and version are resolved automatically, in this order:

Local project install — node_modules/stacktape (version from its package.json).
Global install — ~/.stacktape/bin.
Remote — the latest published schema, as a fallback.

The code lens at the top of a config shows the version in use and warns when validation may not match your installed CLI version.

Commands

Available from the editor title bar, the editor right-click menu, and the Command Palette when a Stacktape config file is open (including TypeScript configs, *.stacktape.ts):

Command	CLI
Stacktape: Validate config	`stacktape validate`
Stacktape: Preview changes (diff)	`stacktape diff`
Stacktape: Deploy stack	`stacktape deploy`

Commands prompt for the target stage and AWS region (remembered per workspace) and run in an integrated terminal, preferring a locally installed CLI (node_modules/.bin) and falling back to a global install on your PATH.

Settings

Setting	Default	Description
`stacktape.validate`	`true`	Enable/disable validation.
`stacktape.hover`	`true`	Enable/disable hover documentation.
`stacktape.completion`	`true`	Enable/disable autocompletion.
`stacktape.validateReferences`	`true`	Flag references to resources/variables not defined in the file. Turn off if your config is split across multiple files.
`stacktape.defaultStage`	`""`	Default stage prefilled for CLI commands.
`stacktape.defaultRegion`	`""`	Default AWS region prefilled for CLI commands.
`stacktape.profile`	`""`	AWS profile passed to CLI commands.
`stacktape.trace.server`	`off`	Trace communication with the language server.

Requirements

VS Code 1.82 or newer.
The Stacktape CLI — required for the Validate / Preview / Deploy commands.

License

MIT