lair404 LLM Connection Monitor

Real-time monitoring of LLM connections with battery-level quota indicators and automatic credential detection.

Features

🔋 Battery-Level Indicators

• Visual battery indicators (🟢🟡🔴) showing remaining quota
• Real-time status bar showing lowest battery level across all connections
• Automatic color-coding (green ≥60%, yellow 20-60%, red <20%)

🔍 Automatic Credential Detection

Scans 5 sources automatically (no manual configuration needed):

1. ~/.claude/config.json (Priority 1)
2. Workspace .env files (Priority 2)
3. VS Code settings (Priority 3)
4. MCP credentials server (Priority 4)
5. wrangler.toml (Priority 5)

📊 Dual Monitoring Categories

Local IDE LLMs:

• Claude Code (Anthropic)
• OpenAI Codex
• Antigravity

Remote API LLMs:

• LiteLLM Gateway models (dynamically discovered from your configured gateway)
• Direct provider APIs (Anthropic, OpenAI, Groq)

⚡ Features

• Auto-refresh: Configurable interval (default: 30 seconds)
• Manual refresh: Click refresh button anytime
• Health checks: Real-time connection status
• MSO integration: Auto-disables duplicate functionality if Multi-Session Orchestrator is installed

Installation

1. Install from .vsix file:

   code --install-extension lair404-llm-connection-monitor-1.0.0.vsix
   

2. Or build from source:

   cd extensions/lair404-llm-connection-monitor
   npm install
   npm run compile
   vsce package
   

Usage

1. View connections: Open the "lair404 LLM Connection Monitor" panel in the activity bar
2. Check status: Battery indicator appears in status bar (right side)
3. Refresh: Click refresh button or wait for auto-refresh
4. Configure: Access settings via gear icon or Preferences > Settings > llmMonitor

Configuration

{
  "llmMonitor.refreshInterval": 30000,
  "llmMonitor.autoRefreshEnabled": true,
  "llmMonitor.showStatusBar": true,
  "llmMonitor.litellmBaseUrl": "https://your-litellm-gateway.example.com",
  "llmMonitor.batteryThresholds": {
    "critical": 20,
    "warning": 60
  }
}

Important: Replace https://your-litellm-gateway.example.com with your actual LiteLLM gateway URL.

Integration with Multi-Session Orchestrator

If the lair404-multi-session-orchestrator extension is installed, this extension will:

• Run as a standalone monitor
• Display in its own activity bar panel
• MSO will hide its built-in LLM usage view to prevent duplication

Requirements

• VS Code 1.85.0 or higher
• Node.js (for building from source)

Architecture

src/
├── models/           # Data models (LlmConnection, LlmCredential)
├── services/         # Business logic
│   ├── CredentialScanner.ts    # 5-source credential detection
│   ├── LiteLLMService.ts       # LiteLLM gateway integration
│   ├── LocalIDEService.ts      # Local IDE monitoring
│   └── StatusBarManager.ts     # Status bar battery indicator
├── providers/        # Tree view providers
│   └── ConnectionsTreeProvider.ts
└── extension.ts      # Main entry point

Version History

1.0.0 (2026-02-04)

• Initial release
• Battery-level quota indicators
• 5-source automatic credential detection
• Dual monitoring (Local IDE + Remote API)
• MSO integration and duplication prevention
• Auto-refresh with configurable interval

Credits

Developed by the lair404 team.

Icon design: Industrial battery cylinder aesthetic.

License

MIT