VS Code Extension

The Prompty VS Code extension is the primary tool for authoring, running, and debugging .prompty files. It includes a built-in TypeScript runtime — no Python installation is required.

graph LR
    A["✏️ Edit .prompty"] --> B["▶ Run (F5)"]
    B --> C["📊 Trace Viewer"]
    C --> A
    style A fill:#4a9eff,color:#fff
    style B fill:#2ea043,color:#fff
    style C fill:#8b5cf6,color:#fff

What’s in the Extension

Area	Capabilities
Language support	TextMate grammar, language server (validation, completion, hover, semantic tokens, document symbols)
Connections	Manage OpenAI, Anthropic, and Microsoft Foundry connections with secure secret storage
Execution	Run prompts, preview rendered output, interactive chat mode for thread-based prompts
Traces	.tracy file format with a full React-based trace viewer
Extensibility	API for other extensions to register providers, executors, and processors

Installation

v2 not yet on the Marketplace

The v2 extension is not yet published to the VS Code Marketplace — the Marketplace version is still v1. To get the latest v2 build, download the .vsix artifact from GitHub CI and install it manually (see below).

From a .vsix file (recommended for v2)

1. Go to the GitHub Actions — VS Code Extension build page
2. Click the most recent successful run
3. Download the vscode-vsix artifact (a .zip containing the .vsix)
4. Extract the .vsix file from the zip
5. In VS Code, open the Command Palette (Ctrl+Shift+P) and run Extensions: Install from VSIX…, then select the file

Or install from the command line:

code --install-extension prompty-0.0.0.vsix

Tip

If you have the v1 extension installed, VS Code will automatically replace it with the .vsix version. You may need to reload the window afterward.

From the Marketplace (v1)

Once the v2 extension is published, you’ll be able to install it directly:

1. Open VS Code
2. Press Ctrl+Shift+X (or Cmd+Shift+X on macOS) to open Extensions
3. Search for Prompty
4. Click Install on the extension by ms-toolsai

code --install-extension ms-toolsai.prompty

Next Steps

Connections Set up OpenAI, Anthropic, or Microsoft Foundry

Editing Language support, creating files, snippets

Running & Preview Execute prompts and live preview

Chat Mode Interactive multi-turn conversations

Tracing Inspect execution traces

Reference Settings, shortcuts, API, troubleshooting