CodeBunker for VS Code

CodeBunker for VS Code is an advanced AI-powered development companion that seamlessly synchronizes your editor with the CodeBunker Desktop Application via an ultra-low latency local bridge. It provides enterprise-grade capabilities to design, protect, and maintain complex codebases efficiently.

[!NOTE] Public Preview: CodeBunker for VS Code is currently in active Public Preview. The companion CodeBunker Desktop Application is undergoing final optimization and will launch soon at codebunker.dev.

🚀 Key Capabilities

🛡️ Real-Time Security & Schema Drift Detection

Automated Security Audits: Analyzes code on save to detect security vulnerabilities, exposed secrets, and bad practices before committing.
Schema Drift Detection: Validates your code against active database schemas in DB Architect in real time, alerting you to broken table or column references.
Dedicated Security Views: Explore detailed findings with direct line jumping and track your hardening progress via the interactive Security Checklist webview.

📦 Project Vault & AI Artifact Smart Routing

Local Vault Storage: Save critical code snippets, configurations, or entire files directly to your project's local vault repository via context menus or keyboard shortcut (Shift+Alt+S).
Smart AI Routing: Automatically classifies AI documents (implementation_plan.md, walkthrough.md, task.md, analysis.md, .resolved) into designated AI categories (AI Plans, AI Tasks, AI Walkthroughs, AI Analysis).
Integrity & Compression: Includes SHA-256 checksum verification and automatic gzip compression for files over 500 KB.

⏱️ Operational Intelligence & Focus Clock

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

🔄 Intelligent Refactoring & Semantic Tools

Smart Code Transformation: Seamlessly transmit code snippets or files to the desktop app for structural conversion across JSON, YAML, XML, SQL, CSV, TypeScript, and more.
Pro Comparator & Semantic Snapshots: Compare AST-level diffs and track complexity variations (cyclomatic, cognitive, maintainability deltas) between checkpoints.
AI Contextual Restore: Generate precision prompts based on past snapshots to adapt or restore code with your favorite AI assistant.

🧠 Autonomous Architecture, Context & Agent Management

Spec-Driven Architecture: Direct access to Spec-Driven Architecture (SDA), Spec-Driven Development (SDD), and Context Layers.
OKF (Operational Knowledge Framework): Structured knowledge base, concept indexing, and context grounding to keep AI agents strictly aligned with project guidelines.
Neural Graph Viewer: Interactive architectural dependency and concept graph visualization directly in the CodeBunker Desktop app.
Skills & Agent Ecosystem: Built-in wizard to create, activate, inspect, and benchmark AI agent skills stored in .codebunker/skills/.
Brain Notes & Mission Log: Capture text or voice notes instantly into your project's RAG memory or Mission Log.

🌐 Embedded API Analyzer & Tester

Built-in HTTP/REST request runner within VS Code.
Automated response timing breakdown (DNS, TLS, TTFB, Total).
Breaking change detection and automatic TypeScript/Rust type generation.

🎨 Themes & CLI Personalization

10 Premium Dark Themes: Includes CodeBunker Dark, Cozy Ember, Cyber-Neon, Deep Teal, Desert Twilight, Emerald Forest, Midnight Focus, Midnight Lavender, Warm Dusk, and Zenith Silence.
CLI Themes Command: Apply CodeBunker color palettes specifically to the VS Code integrated terminal (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 discovers the local connection port and synchronizes project context.
Explore the Sidebar: Access Insights, Workspace Metrics, Code Tools, Brain Notes, Planner, Security Audit Findings, and Security Checklist from the CodeBunker Activity Bar icon.
Execute Commands: Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and type CodeBunker to access all quick actions.

⌨️ 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 for conversion
`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 communicate with CodeBunker Desktop (supports auto-discovery).
`codebunker.autoAnalyze`	`true`	Automatically run security & schema drift checks when saving files.
`codebunker.autoSnapshotOnSave`	`false`	Automatically create a background semantic snapshot on save.
`codebunker.showInlineHints`	`true`	Display CodeLens hints at the top of active code files.
`codebunker.showAppRequirementNotice`	`true`	Show status reminder when desktop app is not connected.

🔗 Architecture & Connectivity

The extension communicates locally via high-speed bi-directional WebSockets with zero external cloud dependencies for local operations. It features:

Proactive Port Discovery: Automatically reads the running desktop port from system application data without manual configuration.
Handshake Authentication: Secure local token handshake ensuring authorized IPC communication.
Live State Synchronization: Real-time project metadata, tracking timers, and background security alerts.

Made with ❤️ by the CodeBunker Team.