⚡ Code Aura — Emotionally Intelligent Coding Companion

"An emotional operating system for developers inside VS Code."

Code Aura is a premium VS Code extension that monitors your behavioral patterns in real time, detects your mental and emotional coding state, and automatically adapts your development environment to help you achieve flow, avoid burnout, and write better code.

🧠 What Is Code Aura?

Most developer tools optimize for code. Code Aura optimizes for the developer writing the code.

Every developer moves through different cognitive states throughout the day — moments of brilliant flow, confusing rabbit holes, frustrating bugs, and accumulating fatigue. Code Aura silently tracks behavioral signals, interprets them through a heuristic scoring engine, and responds intelligently — all without ever reading your code or sending anything outside your machine.

🔍 How It Works

Behavioral Signal Tracking

Code Aura monitors the following editor events locally:

Mood Analysis Engine

Behavioral signals are fed into a heuristic scoring engine that produces six dimensional scores:

• Flow Score — Are you in a high-output, low-error, fast-typing rhythm?
• Focus Score — Is your navigation minimal and deliberate?
• Stress Score — Are errors, backspaces, and failures stacking up?
• Fatigue Score — Are pauses lengthening and activity slowing?
• Confusion Score — Are you rewriting the same logic repeatedly?
• Burnout Risk — Are sustained stress and fatigue compounding?

From these scores, Code Aura classifies your state into one of:

Adaptive Environment

When a state is detected, Code Aura automatically adapts VS Code:

• Flow state detected → Enables Zen Mode, closes sidebar, suppresses distractions
• Frustration detected → Opens the Problems panel, surfaces errors, suggests a break
• Fatigue detected → Suggests a timed break with guided breathing steps
• Burnout risk elevated → Issues a clear, supportive warning with actionable next steps
• Adaptive themes (optional) → Switches color theme based on detected state

💎 Dashboard

Open the dashboard with:

• Command Palette → Code Aura: Open Dashboard
• Click the Aura status bar item (bottom right)

The dashboard features:

Aura Pulse

A glowing animated indicator showing your current state with a confidence score. The color shifts as your state changes — cyan for flow, violet for focus, amber for fatigue, red for frustration.

Cognitive Scores

Six animated meters showing your real-time dimensional scores: Flow, Focus, Stress, Fatigue, Confusion, and Burnout Risk.

Session Overview

• Total session duration
• Minutes spent in peak flow
• Total error count

Typing Rhythm Graph

A smooth bezier curve showing your typing speed over the last 5 minutes — your cognitive signature rendered as a waveform.

Session Timeline

A color-coded strip of your mood states across the full session. Flow periods glow cyan; frustration periods pulse red. Your day's emotional journey, visualized.

Error Heatmap

A ranked list of files with the most accumulated errors. See where your cognitive load is concentrating.

Ambient Sound Controls

Switch between five ambient modes directly from the dashboard:

• Silent — Total silence
• Rain Focus — Soft rain ambience
• Cyber Ambience — Digital background texture
• Lo-Fi — Warm, low-frequency study music
• Deep Work — Dense ambient for maximum concentration

🎵 Ambient Sound

Code Aura can manage ambient sound modes either manually or automatically.

Manual mode: Choose your ambient mode from the dashboard or via Code Aura: Set Ambient Sound Mode.

Auto mode: When codeAura.autoAmbientSound is enabled, Code Aura selects the sound mode that best complements your detected state:

💬 Intelligent Messages

Code Aura surfaces messages that feel supportive, precise, and non-intrusive. Examples:

• "Flow state detected. Minimizing interruptions."
• "You seem stuck in a logic loop. Consider stepping back to review the design."
• "High frustration detected. A short break may restore clarity."
• "You've rewritten this section multiple times. Consider a different approach."
• "Burnout risk elevated. Protect your energy — it's your most valuable resource."
• "Cognitive performance degrades with sustained effort. Rest is productive."

Messages are rate-limited by frequency setting and never repeat consecutively.

⚙️ Configuration

All settings are in VS Code Settings under Code Aura:

🔒 Privacy

Code Aura never reads your code.

Everything runs entirely locally:

• No code, filenames, or content is ever collected
• No telemetry is sent anywhere
• No network requests are made
• All behavioral signals are processed in memory and discarded at session end
• Privacy Mode hides all metrics from the dashboard while tracking continues silently

Code Aura is designed on a privacy-first architecture — the only person with access to your data is you.

🚀 Commands

🏗️ Architecture

Code Aura is built with a clean, modular, event-driven architecture:

extension.ts                  ← Lifecycle + command wiring
├── BehaviorTracker           ← Raw event capture (editor listeners)
├── MoodAnalysisEngine        ← Heuristic scoring + state classification
├── AdaptiveUIController      ← VS Code environment manipulation
├── NotificationManager       ← Rate-limited intelligent messages
├── AudioManager              ← Ambient mode state management
├── SettingsManager           ← Configuration read/write
├── SessionMetricsAggregator  ← Rolling session statistics
└── DashboardPanel            ← Webview lifecycle management
    └── dashboardHTML.ts      ← Premium glassmorphism UI

The MoodAnalysisEngine is designed as a replaceable module — its interface is compatible with a future AI model integration (Anthropic, OpenAI, or local LLM) for significantly higher-accuracy detection.

📋 Requirements

• VS Code 1.74.0 or higher
• No external dependencies — pure VS Code Extension API

🎨 Design Philosophy

Code Aura is designed to feel like premium developer tooling:

• Minimal — Never intrusive. Adapts silently, notifies rarely.
• Intelligent — Responses are proportional to signal strength.
• Supportive — Messages are kind, precise, and actionable.
• Cinematic — The dashboard aesthetic is glassmorphism + cyberpunk minimal.
• Private — Your cognitive state is yours alone.

Code Aura — Your mind, optimized.