https://github.com/acebot712/promptguard-vscode
VS Code extension for PromptGuard - Drop-in LLM security for your applications
https://github.com/acebot712/promptguard-vscode
Last synced: 3 months ago
JSON representation
VS Code extension for PromptGuard - Drop-in LLM security for your applications
- Host: GitHub
- URL: https://github.com/acebot712/promptguard-vscode
- Owner: acebot712
- Created: 2025-11-30T09:05:08.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-04-18T19:26:45.000Z (3 months ago)
- Last Synced: 2026-04-18T20:34:21.685Z (3 months ago)
- Language: TypeScript
- Size: 132 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
[](https://github.com/acebot712/promptguard-vscode/actions/workflows/ci.yml)
[](https://github.com/acebot712/promptguard-vscode/blob/main/LICENSE)
# PromptGuard VS Code Extension
Scan, detect, and secure LLM SDK usage in your codebase - directly in VS Code.
## Features
- **LLM SDK Detection**: Automatically detects OpenAI, Anthropic, Cohere, HuggingFace, Gemini, Groq, and AWS Bedrock 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 without PromptGuard protection
- **Security Scanning**: Scan selected text or files for prompt injection and PII
- **PII Redaction**: Redact sensitive data from selected text
- **CLI Integration**: Seamlessly wraps the PromptGuard CLI
> **Tip:** For new projects, the [PromptGuard SDK](https://docs.promptguard.co/sdks/python) with auto-instrumentation (`promptguard.init()`) is the recommended integration - one line of code secures all LLM calls. The CLI and this extension are best for scanning existing codebases and applying proxy-mode transforms.
## Requirements
- VS Code 1.80.0 or higher
- PromptGuard CLI installed (see [Installation](#installation))
## Installation
### 1. Install the PromptGuard CLI
```bash
curl -fsSL https://raw.githubusercontent.com/acebot712/promptguard-cli/main/install.sh | sh
```
Or install manually from [GitHub Releases](https://github.com/acebot712/promptguard-cli/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:
```bash
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
- AWS Bedrock
## 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](https://promptguard.co)
- [Documentation](https://docs.promptguard.co)
- [CLI Repository](https://github.com/acebot712/promptguard-cli)
- [Report Issues](https://github.com/acebot712/promptguard-vscode/issues)
## License
Apache 2.0