VS Code Extension

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:

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

Prompt Explorer Sidebar

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)