Skip to main content
Run /usage (also /status) to open the usage and billing view for your current account:
The view reads live account data. Allowances, credit packages, upgrade eligibility, offers, and reset times can vary by account and organization.

​
What /usage shows

For an account with a billing plan, the panel can show:
  • current plan;
  • usage consumed from the plan allowance;
  • the allowance reset time;
  • purchased credit usage;
  • credit packages returned for that account;
  • an upgrade action or active account offer when available.
For a free-tier account, the panel shows a usage percentage and reset time instead of a credit count. It can also show the number of projects used against the account’s project limit.
Free-tier usage is intentionally percentage-only. Embedder does not expose its internal cost-denominated credit amount or a monetary conversion in the client.
You can also inspect terminal usage without opening the interactive panel:
This command requires an authenticated account.

​
How allowance and credits are applied

For paid and legacy billing responses, Embedder treats the daily allowance as the first usage pool. Usage above that allowance is measured against purchased credits:
The usage view displays each pool as used over total. It does not define a universal exchange rate between a displayed credit, a model token, and currency. The account service supplies those values. When overages are disabled, the session reaches its daily limit after usage consumes the allowance and purchased-credit pool. Embedder shows a usage limit reached message. When the free usage window is exhausted, the message shows the reset countdown when one is available. Usage already incurred remains recorded after an undo, rewind, or conversation deletion.

​
Purchase credits

Credit packages appear only when the account service returns packages for the current non-free plan. Package labels and credit amounts come from the live response. Selecting a package starts the account’s purchase flow and refreshes /usage after a successful purchase. If no packages are returned, the purchase section is absent. Do not infer that an account supports credit purchases from its plan name alone.

​
Open the upgrade flow

Run:
Aliases are /claim and /offer. The command opens the web subscription flow. If the account has an active offer with its own subscription URL, the VS Code usage action opens that offer. Otherwise, it requests the account’s default checkout or upgrade flow. The usage panel shows an Upgrade action only when the returned account and plan data allow it. Free-tier views do not show a self-service upgrade button, although /upgrade can still open the subscription page directly.
Available plans, package terms, taxes, currencies, and prices are defined in the web flow. This page does not duplicate values that can change by account or region.

​
Account access gates

Embedder checks account and project status before enabling chat. The UI shows the action supported for the returned status. The Check status action asks the backend again. Use it after completing payment, activation, licensing, or evaluation changes in the browser.

​
Free-tier feature gates

Free-tier limits are returned by the account service. In addition to the usage window and project count, they can restrict:
  • which models you can select;
  • which schematic import tools you can use.
If a model is unavailable, the error lists the allowed free models when the backend supplies them. Switch with /model. If a free-tier cost rate is temporarily missing for one model, select another model or retry later. These gates do not imply a fixed plan ladder. Your organization can have account-specific access, licensing, or project policy.

​
Troubleshoot billing status

Confirm that you are signed in and the CLI is connected. Run Embedder: Show CLI Process Output, then retry /usage.
Finish the browser flow, return to Embedder, and select Check status. Restart the session if the status remains stale.
Reopen /usage to refresh the account response. If the purchase result succeeded but the available pool did not change, keep the local logs and contact support.
The account service did not return that action for your account. Use /upgrade to open the subscription page, or contact your team administrator for organization-managed access.
Last modified on August 24, 2026