VS Code Extension

The official DevDiff VS Code Extension brings privacy-first, BYOAI changelog intelligence directly into your editor environment.

---

⚡ Key Features

• Status Bar Integration: One-click staged changes explanation.
• Sidebar Webview: Interactive dashboard showing active files, change stats, and explanations.
• Inline Diffs: Explanations integrated directly into file views.
• Quick Explain: Explain staged changes without leaving VS Code.

---

📦 Installation & Setup

You can install DevDiff in VS Code in two different ways depending on your security policy:

Option A: VS Code Marketplace (Recommended)

1. Open VS Code on your workstation.
2. Open the Extensions View (Ctrl+Shift+X or Cmd+Shift+X).
3. Search for ebula.devdiff or click the direct marketplace link: 👉 DevDiff on the Visual Studio Marketplace
4. Click Install.

Option B: Local VSIX Bundle (Offline / Air-gapped Environments)

For secure enterprise workstations that lack external internet access:

1. Download the latest packaged .vsix file:
   • [devdiff-1.0.2.vsix](file:///c:/Users/Eldrex/Downloads/classhost/DevDiff/devdiff-1.0.2.vsix)
2. In VS Code, open the Extensions View.
3. Click the ... menu in the top-right corner of the Extensions panel.
4. Select Install from VSIX... and select the downloaded package.

---

⚡ Main Capabilities

Feature	Description	Benefit
Active Changes Sidebar	Integrated view summarizing modified files, lines changed, and complexity markers.	High-level context before commits.
Status Bar Actions	Trigger staged changes explanations with a single status bar click.	Frictionless workflow.
Inline Explanation Previews	Displays the generated changelog text inline or inside a separate side-by-side editor.	Fast commit message generation.
Local Swarm Consensuses	Orchestrates a local agent swarm and shows consensus analysis for staged files.	Deep architectural and security insights.

---

⚙️ Configuration & Trust Settings

The extension automatically inherits settings from your repository-level .devdiff.config.js (or .devdiff.config.json) configuration file.

Overriding Settings in VS Code

You can customize the extension via your settings.json:

{
  "devdiff.provider": "ollama",
  "devdiff.model": "llama3.2:3b",
  "devdiff.enableSwarm": true,
  "devdiff.localOnly": true
}

🔒 Enterprise Trust Profile

• Zero Remote Connections: When localOnly is enabled, all execution loops happen on localhost via your local inference provider (WebGPU/Ollama).
• Auto-Redaction: Before compiling any prompt context, credentials and API keys are automatically scanned and redacted locally.