Claude Limits Monitor

Displays your Claude Code rate limit usage directly in the VS Code status bar — session and weekly limits, progress bars, time-to-reset countdown, and color alerts. No extra API overhead during normal use.

Features

• Dual status bar items — session (5-hour) and weekly (7-day) limits shown side by side
• Visual progress bar — 6-segment ██████░░ bar for an instant read on usage
• Color alerts — green → yellow at 50% → red at 80%
• Reset countdown — shows time remaining (~2h, ~3d12h) until the limit window resets
• Auto-clear on reset — if the reset time has already passed, usage drops to 0% automatically without waiting for the next Claude response
• Periodic refresh — status updates every 60 seconds even when Claude is idle
• Click to refresh — click either status bar item to force an immediate update
• Cross-platform — works on Windows, macOS, and Linux

How It Works

The extension reads limit data from ~/.claude/limits.json. This file is written by a Stop hook in Claude Code — a small Node.js script that calls the Anthropic OAuth usage API (/api/oauth/usage) after each Claude session ends and saves the result locally.

Claude Code session ends
        ↓
Stop hook runs save-limits.sh
        ↓
~/.claude/limits.json updated
        ↓
Extension reads file → Status Bar updated

No API calls are made by the extension itself. All data comes from the hook.

Status Bar Format

Сессия: ████░░ 42% (~2h)   |   Неделя: ██░░░░ 18%

Status bar color changes with usage level:

Setup

1. Install the extension

Install from .vsix via Extensions → ··· → Install from VSIX.

2. Create the hook script

Create ~/.claude/hooks/save-limits.sh:

#!/bin/bash
node -e "
const https = require('https');
const fs = require('fs');
const os = require('os');
const path = require('path');

const credsPath = path.join(os.homedir(), '.claude', '.credentials.json');
let token;
try {
  const creds = JSON.parse(fs.readFileSync(credsPath, 'utf8'));
  token = creds.claudeAiOauth?.accessToken;
  if (!token) process.exit(0);
} catch (e) { process.exit(0); }

const options = {
  hostname: 'api.anthropic.com',
  path: '/api/oauth/usage',
  headers: {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json',
    'anthropic-beta': 'oauth-2025-04-20'
  }
};

https.get(options, res => {
  let data = '';
  res.on('data', c => data += c);
  res.on('end', () => {
    try {
      const d = JSON.parse(data);
      const output = {
        five_hour: { used_percentage: d.five_hour?.utilization || 0, resets_at: d.five_hour?.resets_at || null },
        seven_day: { used_percentage: d.seven_day?.utilization || 0, resets_at: d.seven_day?.resets_at || null }
      };
      fs.writeFileSync(path.join(os.homedir(), '.claude', 'limits.json'), JSON.stringify(output));
    } catch (e) {}
  });
}).on('error', () => {});
"

Make it executable (macOS / Linux):

chmod +x ~/.claude/hooks/save-limits.sh

3. Register the hook in Claude Code

Add to ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "bash ~/.claude/hooks/save-limits.sh"
      }]
    }]
  }
}

On Windows, use the full path with quotes:

"command": "bash \"C:/Users/YourName/.claude/hooks/save-limits.sh\""

After setup, the status bar will populate after your next Claude Code session ends.

Requirements

• Claude Code CLI installed and signed in (provides OAuth credentials)
• Node.js available in PATH (for the hook script)
• VS Code 1.85+

Commands

Access via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) or by clicking either status bar item.

Known Limitations

• Limits update only after a Claude Code session ends (Stop hook trigger), not in real time
• Requires Claude Code CLI — does not work with the Claude web interface alone
• OAuth token is read from ~/.claude/.credentials.json; if Claude Code changes its credential storage, the hook may need updating

Release Notes

0.1.4

• Switched to icon.png
• Version bump

0.1.3

• Auto-reset: usage drops to 0% when resets_at timestamp is in the past
• Added 60-second periodic refresh timer (status updates even when file is unchanged)

0.1.2

• Split status bar into two separate items (session / weekly)
• Added reset countdown display

0.1.1

• Added color alerts (green / yellow / red)
• Progress bar visualization

0.1.0

• Initial release