Skip to content

warp.md

Latest commit

 

History

History
51 lines (33 loc) · 2.01 KB

warp.md

File metadata and controls

51 lines (33 loc) · 2.01 KB
Raw
summary Warp provider notes: API token setup and request limit parsing.
read_when
Adding or modifying the Warp provider
Debugging Warp API tokens or request limits
Adjusting Warp usage labels or reset behavior

Warp Provider

The Warp provider reads credit limits from Warp's GraphQL API using an API token.

Features

  • Monthly credits usage: Shows credits used vs. plan limit.
  • Reset timing: Displays the next refresh time when available.
  • Token-based auth: Uses API key stored in Settings or env vars.

Setup

  1. Open Settings → Providers
  2. Enable Warp
  3. In Warp, open your profile menu → Settings → Platform → API Keys, then create a key.
  4. Enter the created wk-... key in CodexBar.

Reference guide: https://docs.warp.dev/reference/cli/api-keys

Environment variables (optional)

  • WARP_API_KEY
  • WARP_TOKEN

How it works

  • Endpoint: https://app.warp.dev/graphql/v2?op=GetRequestLimitInfo
  • Query: GetRequestLimitInfo
  • Fields used: isUnlimited, nextRefreshTime, requestLimit, requestsUsedSinceLastRefresh (API uses request-named fields for credits)

Automatic menu-bar percentages and provider-switcher mini-bars follow Warp's credit consumption order: monthly credits first, then available add-on credits once monthly credits are exhausted. The percentage describes the selected pool; it does not combine the two limits. Credit pools are mapped directly to their layout lanes, so selections work without inventing a quota duration. Explicit Credits and Add-on credits selections continue to show their respective pools, in either used or remaining mode.

If isUnlimited is true, the UI shows “Unlimited” and a full remaining bar.

Troubleshooting

“Missing Warp API key”

Add a key in Settings → Providers → Warp, or set WARP_API_KEY.

“Warp API error”

Confirm the token is valid and that your network can reach app.warp.dev.