devdiff
v1.9.0
Published
Privacy-first, BYOAI codebase intelligence and automated release note synthesizer
Readme
DevDiff VS Code Extension (v1.9.0)
Privacy-first, BYOAI (Bring Your Own AI) inline codebase intelligence and changelog generation for Visual Studio Code.
📦 Installation & Registries
DevDiff is published as a single, universal .vsix package providing identical functionality, offline privacy, and local AI capabilities across both official and open-source editor ecosystems:
Option A: VS Code Marketplace (VS Code, Cursor, Windsurf, Trae)
- Install from Web: Visual Studio Marketplace
- Install via CLI:
code --install-extension ebula.devdiff
Option B: Open VSX Registry (VSCodium, Gitpod, Eclipse Theia, Code-OSS)
- Install from Web: Open VSX Registry
- Install via CLI:
codium --install-extension ebula.devdiff
Option C: Manual VSIX Installation
Download the latest devdiff-1.9.0.vsix and run:
code --install-extension devdiff-1.9.0.vsix🔒 Privacy First
DevDiff never sends your code anywhere. It runs AI locally via Ollama by default. No telemetry. No analytics. No crash reports. Full disclosure →
⭐ Enjoying DevDiff?
If this extension saves you time writing changelogs, please take 30 seconds to leave a review on the VS Code Marketplace or star the GitHub Repository.
Reviews help other developers discover DevDiff and help us prioritize features.
DevDiff explains your Git diffs, parses abstract syntax trees (AST), and maintains persistent codebase memory directly inside VS Code. It is built from the ground up for developers who care about security, privacy, and understanding what changes enter their codebase.
📖 Official Documentation Portal: Learn more about setup, configuration options, and architecture at devdiff.vercel.app.
💬 Questions, Ideas, or Issues?
| I want to... | Go here | | -------------------- | ---------------------------------------------------------------------------------------------------------- | | 💡 Suggest a feature | Feature Requests | | 🐛 Report a bug | Bug Reports | | 💬 Ask a question | GitHub Discussions | | 📖 Read the docs | devdiff.vercel.app |
📦 Installation Options
Option 1: VS Code Marketplace (Recommended)
Search for DevDiff in the Extensions view (Ctrl+Shift+X or Cmd+Shift+X) and click Install.
Option 2: Install from Packaged VSIX
For offline development, air-gapped environments, or pre-release verification:
- Download the packaged VSIX artifact:
devdiff-vscode-1.9.0.vsix(available on GitHub Releases) - Open VS Code.
- Open the Extensions view (
Ctrl+Shift+XorCmd+Shift+X). - Click the
...(More Actions) button in the upper-right corner of the Extensions view. - Select Install from VSIX...
- Select
devdiff-vscode-1.9.0.vsixand click Install.
🚀 Key v1.9.0 Features
- 🖥️ 4 Dedicated Sidebar Views:
- Changelog Explorer: Inspect staged changes, preview changelogs, and render inline Mermaid architecture graphs.
- Q&A Chat Panel: Ask natural language questions against persistent codebase memory in <50ms.
- Security & Compliance Panel: Run one-click vulnerability scans and check code against 10 regulatory frameworks (GDPR, SOC 2, HIPAA).
- Settings & Personas Panel: Configure active AI models, rate limits, secret redaction, and persona filters.
- 💬
@devdiffNative Chat Participant: Use@devdiffdirectly in VS Code Chat to query codebase memory and generate diff summaries. - ⚡ CodeLens & Gutter Annotations: Trigger
⚡ DevDiff: Explain Changesdirectly above modified functions in active text editors. - 🛡️
IDEGuardianProtection: Isolated worker thread execution with a 256MB memory cap and 5s typing activity idle detection to ensure VS Code never freezes. - 🔒 Privacy-First & Local AI: Connects out-of-the-box to local models via Ollama (Llama 3.2, Qwen 2.5 Coder, DeepSeek Coder) or in-browser WebGPU. No telemetry, no cloud relays.
🛠️ Usage & Commands
1. Initialize Workspace Memory
npx devdiff memory init2. Command Palette Actions (Ctrl+Shift+P / Cmd+Shift+P)
DevDiff: Explain Staged Changes— Generates a persona-driven changelog for staged diffs.DevDiff: Send Feedback / Report Issue— Opens the community feedback and review options menu.DevDiff: Open Q&A Chat Panel— Opens the sidebar chat interface for codebase questions.DevDiff: Run Security & Compliance Scan— Scans staged changes against regulatory standards.DevDiff: Show Diagnostic Output— Displays DevDiff extension logs.
⚙️ Configuration Settings
Customize DevDiff under Settings (Ctrl+, or Cmd+,) by searching for devdiff:
| Setting | Type | Default | Description |
| ------------------------------ | --------- | ---------------- | --------------------------------------------------------------------------------------------------------------- |
| devdiff.persona | string | "developer" | Persona perspective (developer, ceo, educator, robot, data-analyst, journalist, pm, compliance) |
| devdiff.provider | string | "ollama-local" | AI model provider (ollama-local, openai-cloud, anthropic-cloud, webllm-gpu) |
| devdiff.model | string | "llama3.2:3b" | Model identifier (e.g. llama3.2:3b, qwen2.5-coder:7b, gpt-4o-mini) |
| devdiff.autoGenerate | boolean | false | Automatically analyze changes when files are staged |
| devdiff.showCodeLens | boolean | true | Display inline ⚡ DevDiff: Explain CodeLens annotations in editor |
| devdiff.memoryCapMb | number | 256 | IDEGuardian worker memory ceiling in megabytes |
| devdiff.idleDetectionSeconds | number | 5 | Pause background analysis when active typing is detected |
🔒 Security & Privacy Guarantees
DevDiff enforces strict local security sandboxing:
- Zero Telemetry: No tracking beacons, analytics scripts, or phone-home calls.
- Redaction Engine v2: Automatically strips API keys, RSA/PEM private keys, and
.envcredentials before any AI processing. - Network Guard: Outbound network calls are restricted exclusively to AI provider endpoints explicitly configured by the user.
📖 Useful Links
- Official Documentation Portal: devdiff.vercel.app
- GitHub Repository: github.com/EldrexDelosReyesBula/devdiff
- Ollama Setup Guide: devdiff.vercel.app/ai-providers/ollama-setup
- Security & Privacy Policy: devdiff.vercel.app/legal/privacy-policy
