Torna alle skill
windsurf-quota
di CodeCraftsmaniac
Windsurf—Non ancora valutato
La tua valutazione
Sintesi
Real-time Windsurf AI quota tracker -- daily, weekly, Cascade messages, flow actions, overage balance. Zero login. Zero config.
Descrizione
<p align="center">
<img src="https://raw.githubusercontent.com/CodeCraftsmaniac/windsurf-quota/main/icon.png" width="120" height="120">
</p>
<h1 align="center">Windsurf Quota</h1>
<p align="center">
<img src="https://img.shields.io/badge/Real--Time-AI_Usage_Tracker-58a6ff?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEzIDJMMyAxNGg5bC0xIDggMTAtMTJoLTlsMS04eiIgZmlsbD0iIzU4YTZmZiIvPjwvc3ZnPg==&logoColor=white&labelColor=0d1117" alt="Real-Time AI Usage Tracker">
</p>
<p align="center">
<b>Zero login. Zero config. Zero delay.</b><br>
<sub>Track your Windsurf AI quotas the moment they change</sub>
</p>
<p align="center">
<a href="https://marketplace.visualstudio.com/items?itemName=CodeCraftsmaniac.windsurf-quota"><img src="https://img.shields.io/badge/Install-Marketplace-0078D4?style=for-the-badge&logo=visual-studio-code&logoColor=white" alt="Marketplace"></a>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota"><img src="https://img.shields.io/badge/Source-GitHub-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"></a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/Updates-Real__Time-2ea043?style=for-the-badge&logo=lightning&logoColor=white">
<img src="https://img.shields.io/badge/Auth-Zero__Login-58a6ff?style=for-the-badge">
<img src="https://img.shields.io/badge/Setup-Zero__Config-a371f7?style=for-the-badge">
<img src="https://img.shields.io/badge/Platform-Win%20%7C%20Mac%20%7C%20Linux-8b949e?style=for-the-badge">
</p>
<p align="center">
<img src="https://img.shields.io/badge/Daily-Quota-f85149?style=flat-square">
<img src="https://img.shields.io/badge/Weekly-Quota-d29922?style=flat-square">
<img src="https://img.shields.io/badge/Cascade-Messages-58a6ff?style=flat-square">
<img src="https://img.shields.io/badge/Flow-Actions-a371f7?style=flat-square">
<img src="https://img.shields.io/badge/Overage-Balance-2ea043?style=flat-square">
</p>
<p align="center">
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota/stargazers"><img src="https://img.shields.io/github/stars/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=58a6ff" alt="Stars"></a>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota/fork"><img src="https://img.shields.io/github/forks/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=a371f7" alt="Forks"></a>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota/issues"><img src="https://img.shields.io/github/issues/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=d29922" alt="Issues"></a>
</p>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Activity
<p align="center">
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota/graphs/commit-activity"><img src="https://img.shields.io/github/commit-activity/t/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=58a6ff" alt="Commit Activity"></a>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota/releases"><img src="https://img.shields.io/github/v/release/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=2ea043" alt="Releases"></a>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota"><img src="https://img.shields.io/github/last-commit/CodeCraftsmaniac/windsurf-quota?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117&color=a371f7" alt="Last Commit"></a>
</p>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Preview
<table align="center">
<tr>
<td align="center"><b>Status Bar Widget</b></td>
<td align="center"><b>Hover Tooltip</b></td>
</tr>
<tr>
<td align="center"><img src="https://raw.githubusercontent.com/CodeCraftsmaniac/windsurf-quota/main/images/widget.png" alt="Widget" width="400"></td>
<td align="center"><img src="https://raw.githubusercontent.com/CodeCraftsmaniac/windsurf-quota/main/images/tooltip.png" alt="Tooltip" width="400"></td>
</tr>
</table>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Features
<table align="center">
<tr>
<td><img src="https://img.shields.io/badge/-Real__Time-2ea043?style=flat-square"></td>
<td><b>Instant updates</b> via fs.watch() -- fires the moment the DB changes</td>
</tr>
<tr>
<td><img src="https://img.shields.io/badge/-Zero__Login-58a6ff?style=flat-square"></td>
<td><b>No API calls</b>, no browser automation, no Selenium, no .env files</td>
</tr>
<tr>
<td><img src="https://img.shields.io/badge/-Zero__Config-a371f7?style=flat-square"></td>
<td><b>Auto-detects</b> Windsurf's state.vscdb on Windows, macOS, and Linux</td>
</tr>
<tr>
<td><img src="https://img.shields.io/badge/-Color__Coded-f85149?style=flat-square"></td>
<td><b>Green / Yellow / Red</b> progress bars based on remaining quota</td>
</tr>
<tr>
<td><img src="https://img.shields.io/badge/-Cascade-d29922?style=flat-square"></td>
<td><b>Messages, Flow Actions, Flex Credits</b> tracked with block bars</td>
</tr>
<tr>
<td><img src="https://img.shields.io/badge/-Overage-58a6ff?style=flat-square"></td>
<td><b>Pay-per-use balance</b> shown in status bar and tooltip</td>
</tr>
</table>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Quota Breakdown
<div align="center">
| Metric | Status Bar | Tooltip | Format |
|:-------|:----------:|:-------:|:-------|
| **Plan Name** | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | Free / Pro / Ultimate / Team |
| **Daily Quota** | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | `[██████████░░░░░░░░░░]` + % + timer |
| **Weekly Quota** | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | `[██████████░░░░░░░░░░]` + % + timer |
| **Cascade Messages** | | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | used / total + bar |
| **Flow Actions** | | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | used / total + bar |
| **Flex Credits** | | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | used / total + bar |
| **Overage Balance** | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | `$XX.XX remaining` + bar |
| **Billing Strategy** | | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | quota / overage |
| **Account Email** | | <img src="https://img.shields.io/badge/-YES-2ea043?style=flat-square"> | auto from DB |
</div>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Color Coding
<div align="center">
| Range | Status | Bar Color |
|:------|:------:|:---------:|
| >= 50% remaining | <img src="https://img.shields.io/badge/Safe-2ea043?style=flat-square"> | `██████████` |
| 20-49% remaining | <img src="https://img.shields.io/badge/Low-d29922?style=flat-square"> | `██████████` |
| < 20% remaining | <img src="https://img.shields.io/badge/Critical-f85149?style=flat-square"> | `██████████` |
</div>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Installation
<div align="center">
### Option 1: Marketplace *(recommended)*
Search **"Windsurf Quota"** in the Extensions panel, then click **Install**.
```bash
code --install-extension CodeCraftsmaniac.windsurf-quota
```
### Option 2: VSIX
Download the [latest release](https://github.com/CodeCraftsmaniac/windsurf-quota/releases) and run:
```bash
code --install-extension windsurf-quota-2.0.0.vsix
```
### Option 3: Manual
1. Clone or download from [GitHub](https://github.com/CodeCraftsmaniac/windsurf-quota)
2. Copy to your extensions directory:
```bash
# 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/
```
3. **Restart Windsurf IDE** -- the widget appears in the status bar!
</div>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Commands & Settings
<div align="center">
| 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) |
</div>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Architecture
<div align="center">
<img src="https://img.shields.io/badge/Windsurf_IDE-state.vscdb-58a6ff?style=for-the-badge" alt="State DB">
```
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)
</div>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
## Contributing
<p align="center">
<img src="https://img.shields.io/badge/1-Fork-181717?style=flat-square&logo=github">
<img src="https://img.shields.io/badge/2-Branch-58a6ff?style=flat-square&logo=git">
<img src="https://img.shields.io/badge/3-Commit-2ea043?style=flat-square&logo=git">
<img src="https://img.shields.io/badge/4-Push-d29922?style=flat-square&logo=git">
<img src="https://img.shields.io/badge/5-PR-a371f7?style=flat-square&logo=github">
</p>
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
<p align="center">
<img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge"><br>
<sub>MIT (c) <a href="https://github.com/CodeCraftsmaniac">CodeCraftsmaniac</a></sub><br><br>
<a href="https://github.com/CodeCraftsmaniac/windsurf-quota"><img src="https://img.shields.io/badge/Star_on-GitHub-181717?style=for-the-badge&logo=github&logoColor=white&labelColor=0d1117" alt="Star"></a>
</p>
Installazione
Installa la skill da https://github.com/CodeCraftsmaniac/windsurf-quotaQuesta skill non è pubblicata sul registro ClawHub. Incolla il prompt nel tuo agente di coding — Claude Code, Cursor, Codex — e installerà la skill direttamente dal repository sorgente.
Apri il repository