Skip to content

REPOZY/Claude-Status-Monitor-Extension

Repository files navigation

Claude Status Monitor

A VS Code extension that keeps Claude service health visible in your status bar, with a detailed incident panel and optional notifications for changes.

What This Tool Is

Claude Status Monitor is a lightweight extension for developers who rely on Claude API and Claude Code availability during daily work.

Instead of checking the status website manually, you get:

  • Live status in the VS Code status bar
  • A webview panel with component and incident details
  • Optional notifications for incident and component changes

Why I Created It

I built this extension because service status directly affects development flow, CI reliability, and incident response.

When Claude availability changes, I want that context inside my IDE immediately so I can:

  • quickly identify whether slow completions are model latency or a service-wide degradation
  • correlate timeouts, retries, and elevated API error rates with active incidents
  • avoid wasting debugging time on application code when the upstream platform is unstable
  • decide when to pause deploys, adjust fallback logic, or communicate ETA/risk to teammates
  • stay in the IDE instead of repeatedly opening status.claude.com in a browser tab

A complete yet discreet status bar within your IDE, that shows a status summary on-hover:

When you click on the status bar, it will open a more detailed webview panel.

How It Works

The extension polls the official Claude status endpoints from https://status.claude.com/api/v2/:

  • /status.json
  • /components.json
  • /incidents.json

Runtime flow

  1. On startup, polling begins automatically.
  2. Data is stored in an in-memory status store.
  3. The status bar reflects the worst status across your watched components.
  4. Clicking the status bar opens the detailed panel.
  5. If changes are detected (new incidents, updates, component transitions), notifications are emitted when enabled.

Reliability behavior

  • Polling interval is configurable.
  • Minimum interval is enforced at 15 seconds.
  • Failed fetches use exponential backoff (up to 5 minutes).

Features

  • Status bar indicator: Claude Service Status
  • Severity-based icon and background color
  • Click-to-open detail panel with:
  • watched component statuses
  • active incidents
  • recent resolved incidents
  • Optional pop-up notifications for:
  • new incidents
  • incident updates
  • incident resolution
  • watched component status transitions
  • Manual refresh command

Installation

From VSIX (local)

  1. Open VS Code.
  2. Go to Extensions.
  3. Click the ... menu.
  4. Choose Install from VSIX....
  5. Select claude-status-monitor-1.0.0.vsix.

From source

npm install
npm run build
vsce package

npm run build generates the bundled extension output in dist/.

Use vsce package after building when you want to create a local .vsix, or load the project in an Extension Development Host from VS Code for development.

Usage

  • Watch the status bar item labeled Claude Service Status.
  • Click it to open the full status panel.
  • Use command palette:
  • Claude Status: Show Status Panel
  • Claude Status: Refresh Now

Configuration

Settings are under claudeStatus:

Setting Type Default Description
claudeStatus.pollingInterval number 60 Polling interval in seconds (minimum 15)
claudeStatus.watchedComponents string[] ['Claude API (api.anthropic.com)', 'Claude Code'] Components to track in status bar + panel
claudeStatus.showNotifications boolean true Enable/disable pop-up notifications

Commands

Command Description
claudeStatus.showPanel Open the status webview panel
claudeStatus.refresh Trigger an immediate status poll

Tech Stack

  • TypeScript
  • VS Code Extension API
  • esbuild for bundling
  • Native https requests to official Claude status APIs

License

MIT

About

IDE extension that shows Claude API and Claude Code service status in your status bar, with incident details and optional notifications.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors