CodeBunker for VS Code

CodeBunker for VS Code is the official editor companion for the CodeBunker Desktop Application. It seamlessly bridges your editor with your local CodeBunker workspace via a local WebSocket bridge, giving you direct access to workspace intelligence, real-time security audits, schema drift detection, and local vault backups right from your IDE.

[!IMPORTANT] Companion Application Required: This extension operates as a local bridge and is designed to work in tandem with the CodeBunker Desktop Application running locally on your computer. While themes work out of the box, core telemetry, security scanning, and vault synchronization require the companion desktop app. The desktop app is currently in active Public Preview and will launch soon at codebunker.dev.

🚀 Key Capabilities

🛡️ Real-Time Security & Schema Drift Detection

Automated Security Audits: Triggers automated security checks on file save via your local CodeBunker engine to detect vulnerabilities, exposed secrets, and bad practices before committing.
Schema Drift Detection: Validates code references against database schemas registered in DB Architect, surfacing warnings in VS Code when broken tables or columns are detected.
Dedicated Security Views: Inspect detailed audit findings with direct file line jumping and track hardening progress via the interactive Security Checklist and Audit Findings views.

📦 Project Vault & AI Artifact Smart Routing

Local Vault Storage: Save critical code snippets, configurations, or entire files directly to your project's secure local vault repository (Shift+Alt+S).
Smart AI Routing: Automatically identifies and categorizes AI documents (implementation_plan.md, walkthrough.md, task.md, analysis.md, .resolved) generated by AI tools (such as Antigravity, Cursor, or Windsurf) into designated Vault sections (AI Plans, AI Tasks, AI Walkthroughs, AI Analysis).
Integrity & Efficiency: Validates file integrity via SHA-256 checksums and automatically compresses large payloads to keep local storage lightweight.

⏱️ Operational Intelligence & Focus Clock

Status Bar Focus Clock: Real-time work state tracking (Operating, Resting, Standby) and daily focus duration (Xh Ym) displayed directly in your VS Code status bar.
Interactive Work Sessions: Start, pause, or switch between work sessions and breaks directly from the CodeBunker sidebar.
Workspace Activity Heatmap: Visual heatmap in the sidebar showing project activity density, lines of code, and engagement metrics.

🔄 Code Tools & Desktop Handoff

CodeMorph Structural Conversion: Send code snippets or active files directly to CodeBunker Desktop with one click to convert structures across JSON, YAML, XML, SQL, CSV, TypeScript, and more.
Pro Comparator Integration: Hand off active code to CodeBunker Desktop's deep comparator for AST-level semantic diffs and complexity metrics (cyclomatic, cognitive, maintainability).
AI Contextual Restore: Generate precision recovery prompts based on historical project snapshots to adapt or restore code with your favorite AI assistant.

🧠 Workspace Knowledge & Skills

Brain Notes & Mission Log: Quickly log text notes, architectural concepts, and Mission Log progress directly from the VS Code sidebar into your project context.
Skills Management: Inspect active AI agent skills in your project, view execution statistics, and create new skill templates (.codebunker/skills/) directly from VS Code.

🌐 Embedded API Request Runner

Integrated Request Runner: Execute REST/HTTP requests from a dedicated panel inside VS Code, powered by CodeBunker's local testing runner.
Timing & Payload Inspection: View total response latency, response payloads, status codes, and save requests into collections.

🎨 10 Premium Dark Themes & CLI Styling

10 Built-in Themes: Includes CodeBunker Alpha Dark, Cozy Ember, Cyber-Neon, Deep Teal, Desert Twilight, Emerald Forest, Midnight Focus, Midnight Lavender, Warm Dusk, and Zenith Silence.
Integrated Terminal Palette: Apply CodeBunker color palettes to your integrated terminal via CodeBunker: Set CLI Theme.

⚡ Getting Started

Launch CodeBunker Desktop: Open the CodeBunker desktop application.
Open Workspace in VS Code: Open your project folder in VS Code. The extension automatically detects the active local port and establishes the connection.
Explore the Sidebar: Access Home, Workspace Metrics, Code Tools, Brain Notes, Task Planner, and Security Audits from the CodeBunker Activity Bar icon.
Execute Commands: Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and type CodeBunker to view all available commands.

⌨️ Useful Commands & Shortcuts

Command	Shortcut	Description
`CodeBunker: Send to Vault`	`Shift+Alt+S`	Save current file or selection to project's secure Vault
`CodeBunker: Send to CodeMorph`	Command Palette / Sidebar	Send active code to CodeMorph in CodeBunker Desktop
`CodeBunker: Analyze Code`	Command Palette	Trigger instant security and schema analysis
`CodeBunker: Set CLI Theme`	Command Palette	Apply theme colors to the integrated terminal
`CodeBunker: Open API Analyzer`	Command Palette	Open the embedded REST API testing panel
`CodeBunker: Create Skill`	Command Palette	Launch the wizard to create a new AI Skill
`CodeBunker: Reconnect`	Command Palette	Re-establish connection with Desktop App

⚙️ Extension Settings

Setting	Default	Description
`codebunker.websocketPort`	`9876`	Base port used to connect with CodeBunker Desktop (supports automatic port discovery).
`codebunker.autoAnalyze`	`true`	Automatically run security & schema drift checks when saving files.
`codebunker.autoSnapshotOnSave`	`false`	Automatically trigger a background snapshot on save.
`codebunker.showInlineHints`	`true`	Display CodeLens hints at the top of active code files.
`codebunker.showAppRequirementNotice`	`true`	Show status reminder when the companion desktop app is not connected.

🔗 Architecture & Security

Strictly Local Communication: All communication between VS Code and CodeBunker Desktop happens exclusively over a local loopback WebSocket (127.0.0.1), ensuring zero external cloud exposure of your proprietary source code.
Session-Bound Handshake: Connection requests are authenticated using session-bound handshake tokens.
Zero Telemetry Leakage: No telemetry or code data is transmitted to third-party tracking servers.

Made with ❤️ by the CodeBunker Team.