VS Code Extension

Echo DSL language support for VS Code

VS Code Extension

Full language support for .pdk, .echo, .eval, and .dset files — syntax highlighting, diagnostics, autocomplete, and integrated CLI commands.

Installation

Search for “Echo PDK” in the VS Code Extensions marketplace, or:

bash
code --install-extension goreal-ai.echo-pdk

Syntax Highlighting

  • Variables: {{name}}, {{user.role:text}}, {{image:file}}
  • Conditionals: [#IF], [ELSE], [END IF]
  • Sections: [#SECTION], [#INCLUDE], [#IMPORT]
  • Operators: #equals(...), #ai_gate(...), etc.

Real-Time Diagnostics

  • Unclosed blocks ([#IF] without [END IF])
  • Unknown or deprecated operators
  • Undefined variables
  • Invalid variable types and context paths
  • Unused sections
  • Eval file validation (missing suite/target, invalid assertions)

Autocomplete

Context-aware completions triggered by:

  • # — Operators: #equals, #contains, #ai_gate, etc.
  • [ — Control structures: [#IF], [#SECTION], [#IMPORT]
  • : — Variable types: :text, :boolean, :number, :file

The Echo PDK activity bar panel provides a tree view of local and remote prompts. Browse, open, and manage prompts directly from the sidebar.

Commands

Access via Command Palette (Cmd+Shift+P):

  • Initialize Workspace — Create echo.workspace.yaml
  • New Prompt / Eval / Dataset — Scaffold files
  • Validate / Render Preview / Run with LLM
  • Pull / Push to PLP — Sync with your PLP server
  • Browse Versions / Publish / Deploy
  • Run Eval on PLP — Execute eval remotely
  • Upload Asset / Manage Context

Settings

  • echoPdk.cliPath — Path to CLI (auto-detected)
  • echoPdk.plp.serverUrl — PLP server URL
  • echoPdk.plp.apiKey — PLP API key (or use ECHO_PLP_TOKEN env var)