Windsurf Quota

Zero login. Zero config. Zero delay.
_{Track your Windsurf AI quotas the moment they change}

Activity

Preview

Status Bar Widget	Hover Tooltip

Features

	Instant updates via fs.watch() -- fires the moment the DB changes
	No API calls, no browser automation, no Selenium, no .env files
	Auto-detects Windsurf's state.vscdb on Windows, macOS, and Linux
	Green / Yellow / Red progress bars based on remaining quota
	Messages, Flow Actions, Flex Credits tracked with block bars
	Pay-per-use balance shown in status bar and tooltip

Quota Breakdown

Metric	Status Bar	Tooltip	Format
Plan Name			Free / Pro / Ultimate / Team
Daily Quota			`[██████████░░░░░░░░░░]` + % + timer
Weekly Quota			`[██████████░░░░░░░░░░]` + % + timer
Cascade Messages			used / total + bar
Flow Actions			used / total + bar
Flex Credits			used / total + bar
Overage Balance			`$XX.XX remaining` + bar
Billing Strategy			quota / overage
Account Email			auto from DB

Color Coding

Range	Status	Bar Color
>= 50% remaining		`██████████`
20-49% remaining		`██████████`
< 20% remaining		`██████████`

Installation

Option 1: Marketplace (recommended)

Search "Windsurf Quota" in the Extensions panel, then click Install.

code --install-extension CodeCraftsmaniac.windsurf-quota

Option 2: VSIX

Download the latest release and run:

code --install-extension windsurf-quota-2.0.0.vsix

Option 3: Manual

Clone or download from GitHub
Copy to your extensions directory:

# Windows
xcopy /E . "%USERPROFILE%\.windsurf\extensions\codecraftsmaniac.windsurf-quota-2.0.0-universal\"

# macOS / Linux
cp -r . ~/.windsurf/extensions/codecraftsmaniac.windsurf-quota-2.0.0-universal/

Restart Windsurf IDE -- the widget appears in the status bar!

Commands & Settings

Command	Description
`Windsurf Quota: Show Details`	Opens the detail panel with full breakdown
`Windsurf Quota: Refresh Now`	Force-refresh quota data from DB

Setting	Default	Description
`windsurfQuota.refreshIntervalSeconds`	`15`	Fallback polling interval (seconds)
`windsurfQuota.stateDbPath`	auto	Path to `state.vscdb` (auto-detected if empty)

Architecture

Windsurf IDE                          Extension
-----------                          ---------
state.vscdb  ──── fs.watch() ────>  Real-time update
  |                                    |
  ├── cachedPlanInfo ─────────────>  Daily/Weekly/Cascade/Overage
  └── codeium.windsurf ───────────>  Email/Billing/Plan

Data source: windsurf.settings.cachedPlanInfo + codeium.windsurf keys
Real-time: fs.watch() on the DB file -- fires instantly on change
Fallback: mtime polling every 2s + interval poll every 15s
Python required: Uses Python to read SQLite (auto-detected)