🏥 Extension Health Monitor

Monitor, analyze, and optimize your VS Code extensions performance in real time.

Stop guessing which extensions are slowing down your editor. Extension Health Monitor gives you a complete health dashboard with actionable insights to keep VS Code fast and lean.

📸 Screenshots

✨ Features

🎯 Health Score System

Every installed extension receives a health score from 0 to 100 based on:

• ⚡ Activation time — How long the extension takes to start
• 💾 Memory impact — Estimated memory consumption
• 📊 Usage frequency — How often you actually use it
• 🕐 Last used date — When was the last time it was active
• 🔄 Active state — Whether it's running without being needed

📊 Interactive Dashboard

A full-featured web dashboard right inside VS Code:

• Overall health score displayed in a visual circle indicator
• Stat cards showing total, healthy, warning, and critical extension counts
• Sortable & filterable table with all extension details
• Real-time search across all extensions
• One-click actions — View, Disable, or Uninstall any extension
• Toast notifications for instant feedback on every action

Open it with Ctrl+Shift+P → Extension Health: Show Dashboard

📍 Status Bar Indicator

A persistent indicator in your status bar shows the overall health score at a glance:

• ✅ $(check) 85 — Everything looks good (score ≥ 80)
• ⚠️ $(warning) 62 — Some issues detected (score 50–79)
• ❌ $(error) 34 — Critical issues need attention (score < 50)

Click it to instantly open the dashboard.

🔍 Full Scan

Run a comprehensive analysis of all installed extensions:

• Measures activation time for every active extension
• Estimates memory footprint based on dependencies and features
• Checks usage history and frequency
• Identifies inactive extensions consuming resources
• Generates issue reports with severity levels

Ctrl+Shift+P → Extension Health: Run Full Scan

🧹 Unused Extension Detection

Automatically identifies extensions you haven't used in a configurable number of days:

• Default threshold: 30 days
• Shows a quick pick list with all unused extensions
• Displays last used date for each extension
• Allows batch selection for review
• Excludes themes from unused detection (since they're passive)

Ctrl+Shift+P → Extension Health: Disable Unused Extensions

⚠️ Issue Detection

Each extension is analyzed for potential problems:

⚡ Smart Recommendations

The recommendation engine suggests actions based on extension behavior:

• Uninstall — Extensions never tracked as used
• Disable — Extensions with activation time > 3 seconds
• Disable per workspace — High memory usage + low frequency
• Cleanup — Unused themes taking up space
• Impact estimates — See how much memory and startup time you'd save

🏷️ Extension Categorization

Extensions are automatically categorized for easier management:

🔀 Conflict Detection

Detects potential conflicts between installed extensions:

• Formatter conflicts — Multiple formatters for the same language
• Keybinding conflicts — Extensions using the same keyboard shortcuts
• Known conflicts — Database of known problematic extension pairs
• Resolution suggestions — Actionable steps to fix each conflict

Examples of detected conflicts:

📋 Report Generation

Export a complete health report with one click:

• Overall score and breakdown
• Total vs active extension count
• Health distribution (healthy / warning / critical)
• Full extension list with scores and issues
• Category breakdown
• Timestamp for tracking over time

Copy to clipboard as formatted JSON — perfect for sharing with your team.

📈 Historical Tracking

Extension health data is tracked over time:

• Snapshots saved after every scan
• Up to 100 historical snapshots stored
• Query history by date range
• Track score trends per extension
• Monitor overall health improvement

🎨 Dashboard Filters & Search

Quickly find what you need:

• Filter buttons — Show All, Critical only, Warning only, Healthy only
• Live search — Type to filter extensions by name, ID, or any visible text
• Visual indicators — Color-coded rows, score badges, and category tags
• Issue badges — Severity-colored issue descriptions inline

🚀 Getting Started

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Extension Health Monitor"
4. Click Install
5. Reload VS Code if prompted

First Use

1. The extension activates automatically after VS Code starts
2. Look for the health score in the status bar (bottom right)
3. Click it or run Extension Health: Show Dashboard from the command palette
4. Run a Full Scan to get detailed analysis

📝 Available Commands

Open the Command Palette (Ctrl+Shift+P) and type "Extension Health":

⚙️ Configuration

Customize behavior in VS Code settings (Ctrl+,):

Example settings.json

{
  "extHealth.monitoringInterval": 60000,
  "extHealth.unusedThresholdDays": 14,
  "extHealth.showStatusBar": true,
  "extHealth.enableNotifications": true,
  "extHealth.performanceThreshold": 300
}

🔒 Privacy & Security

• All data stays local — Nothing is sent to external servers
• No telemetry — Zero tracking or analytics
• No network requests — Works completely offline
• Stored in VS Code's global state — Data follows your VS Code profile
• XSS protected — All dynamic content is sanitized before rendering

🤝 Contributing

Contributions are welcome! Here's how to get started:

Development Setup

# Clone the repository
git clone https://github.com/wallacefrota/extension-health-monitor.git
cd extension-health-monitor

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode (auto-recompile on changes)
npm run watch

Testing

# Press F5 in VS Code to launch Extension Development Host
# Open Command Palette → "Extension Health: Show Dashboard"

📄 License

This project is licensed under the MIT license.