PromptGuard VS Code Extension

Drop-in LLM security for your applications - directly in VS Code.

Features

• LLM SDK Detection: Automatically detects OpenAI, Anthropic, Cohere, and HuggingFace SDKs in your code
• Status Indicator: See PromptGuard status at a glance in the status bar
• One-Click Setup: Initialize PromptGuard with a single command
• Real-time Diagnostics: Get warnings when LLM SDKs are detected
• CLI Integration: Seamlessly wraps the PromptGuard CLI

Requirements

• VS Code 1.80.0 or higher
• PromptGuard CLI installed (see Installation)

Installation

1. Install the PromptGuard CLI

curl -fsSL https://raw.githubusercontent.com/acebot712/promptguard-cli/main/install.sh | sh

Or install manually from GitHub Releases.

2. Install the Extension

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "PromptGuard"
4. Click Install

Or install from the command line:

code --install-extension promptguard.promptguard-vscode

Usage

Initialize PromptGuard

1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Run PromptGuard: Initialize
3. Enter your API key when prompted
4. Select providers (or press Escape to use all)

Scan for LLM SDKs

1. Run PromptGuard: Scan for LLM SDKs from Command Palette
2. View results in the Output channel

Check Status

• Click the status bar indicator (bottom right)
• Or run PromptGuard: Show Status from Command Palette

Apply Transformations

1. Run PromptGuard: Apply Transformations from Command Palette
2. Confirm the action
3. Your code will be automatically transformed to use PromptGuard

Configuration

CLI Path

If the CLI is not in your PATH, you can set a custom path:

1. Open Settings (Cmd+, / Ctrl+,)
2. Search for "PromptGuard"
3. Set PromptGuard: Cli Path to the full path to the binary

Example: /usr/local/bin/promptguard or C:\Program Files\PromptGuard\promptguard.exe

Commands

• PromptGuard: Initialize - Set up PromptGuard in your project
• PromptGuard: Scan for LLM SDKs - Scan project for LLM SDK usage
• PromptGuard: Show Status - Display current configuration
• PromptGuard: Apply Transformations - Apply PromptGuard transformations
• PromptGuard: Disable - Temporarily disable PromptGuard
• PromptGuard: Enable - Re-enable PromptGuard

Status Bar

The status bar shows:

• Active - PromptGuard is active and protecting your app
• Disabled - PromptGuard is temporarily disabled
• Not initialized - PromptGuard hasn't been set up yet

Click the status bar to view detailed status.

Supported Languages

• TypeScript (.ts, .tsx)
• JavaScript (.js, .jsx)
• Python (.py)

Supported Providers

• OpenAI
• Anthropic
• Cohere
• HuggingFace
• Gemini (Google)
• Groq

Troubleshooting

CLI Not Found

If you see "CLI not found" errors:

1. Verify the CLI is installed: promptguard --version
2. Check it's in your PATH: which promptguard (macOS/Linux) or where promptguard (Windows)
3. Set the promptguard.cliPath setting to the full path

Extension Not Working

1. Check the Output channel: View → Output → Select "PromptGuard"
2. Reload the window: Cmd+Shift+P → "Developer: Reload Window"
3. Check VS Code version: Must be 1.80.0 or higher

Links

• PromptGuard Website
• Documentation
• CLI Repository
• Report Issues

License

Apache 2.0