Windsurf Credit Throttle
A Streamlit application for managing Windsurf add-on credit caps.
Features
- Verify Credit Caps: Check team-level and individual user credit configurations
- Set Team Cap: Configure organization-wide add-on credit limits
- Set Individual Caps: Set custom caps for specific users or bulk import from CSV
Installation
Using uvx (recommended)
# Run directly from GitHub
uvx --from git+https://github.com/rappdw/windsurf-throttle windsurf-throttle
# Or from PyPI (when published)
uvx windsurf-throttle
Using pip
pip install windsurf-throttle
windsurf-throttle
From source
git clone https://github.com/rappdw/windsurf-throttle.git
cd windsurf-throttle
uv sync
uv run windsurf-throttle
Configuration
Set your Windsurf service key as an environment variable:
export WINDSURF_SERVICE_KEY=your_service_key_here
Or create a .env file in your working directory:
WINDSURF_SERVICE_KEY=your_service_key_here
Optional Configuration
# Override the API base URL (default: https://server.codeium.com)
export WINDSURF_BASE_URL=https://custom.server.com
Usage
Running the App
# Using the CLI
windsurf-throttle
# Or run Streamlit directly
streamlit run src/windsurf_throttle/app.py
Credit Cap Strategy
The app implements the following strategy:
- Base Credits: Each user gets 500 base credits
- Organization Cap: Set a default add-on cap for all users (e.g., 1000)
- Individual Caps: For high-usage users, set individual caps = current add-on usage + buffer
Example:
- User with 1200 total credits used → 700 add-on credits used
- Individual cap = 700 + 500 buffer = 1200 add-on credits
- Total available = 500 base + 1200 add-on = 1700 credits
Bulk CSV Import
Upload a CSV with these columns:
email(required): User email addresscredits_used(required): Current total credit usagename(optional): User display name
Development
# Clone and install dev dependencies
git clone https://github.com/rappdw/windsurf-throttle.git
cd windsurf-throttle
uv sync --all-extras
# Run tests
uv run pytest
# Run linting
uv run ruff check src tests
uv run mypy src
# Install pre-commit hooks
uv run pre-commit install
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
windsurf_throttle-1.2.0.tar.gz
(112.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file windsurf_throttle-1.2.0.tar.gz.
File metadata
- Download URL: windsurf_throttle-1.2.0.tar.gz
- Upload date:
- Size: 112.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
993a95cbe6b87431ec32e6bf2f19007955c864276dfb1901a4d6bcd1bbb9c612
|
|
| MD5 |
5f30332648c86ad0db0a14a21c570aa3
|
|
| BLAKE2b-256 |
9739d62b2269f832406350a6a04b871bd33badf413393bc235c3ddef7cf82804
|
Provenance
The following attestation bundles were made for windsurf_throttle-1.2.0.tar.gz:
Publisher:
publish.yml on rappdw/windsurf-throttle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
windsurf_throttle-1.2.0.tar.gz -
Subject digest:
993a95cbe6b87431ec32e6bf2f19007955c864276dfb1901a4d6bcd1bbb9c612 - Sigstore transparency entry: 2138582700
- Sigstore integration time:
-
Permalink:
rappdw/windsurf-throttle@8806c5f7990e2df7477e4f48ac6dbcbb61528bc9 -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/rappdw
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8806c5f7990e2df7477e4f48ac6dbcbb61528bc9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file windsurf_throttle-1.2.0-py3-none-any.whl.
File metadata
- Download URL: windsurf_throttle-1.2.0-py3-none-any.whl
- Upload date:
- Size: 13.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb24a04a544505e4a75b3c95427c61032847b1b9e179071e87eacf7da7a42aa1
|
|
| MD5 |
842f975bf3fd991093660f916746ebb8
|
|
| BLAKE2b-256 |
5b78fabff77ee7503f34353855454a34367f6dac09952f76878124fbea262101
|
Provenance
The following attestation bundles were made for windsurf_throttle-1.2.0-py3-none-any.whl:
Publisher:
publish.yml on rappdw/windsurf-throttle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
windsurf_throttle-1.2.0-py3-none-any.whl -
Subject digest:
fb24a04a544505e4a75b3c95427c61032847b1b9e179071e87eacf7da7a42aa1 - Sigstore transparency entry: 2138582713
- Sigstore integration time:
-
Permalink:
rappdw/windsurf-throttle@8806c5f7990e2df7477e4f48ac6dbcbb61528bc9 -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/rappdw
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8806c5f7990e2df7477e4f48ac6dbcbb61528bc9 -
Trigger Event:
release
-
Statement type:
