Docs › Account and usage › Usage and limits

Usage and limits

See how much of your plan is left and when it resets, what happens when it runs out, and how additional usage and its spending limit work.

On this page

Your AstraCode plan includes an allowance that chat, the agent, tab completion, dictation and web search all draw on. AstraCode shows it in one way everywhere: how much of your allowance is left, and the date it resets. What each plan includes, and what it costs, is on the pricing page.

The allowance is measured by what each piece of work costs to run, not by how many messages you send, so light work such as a short question goes further than a long agent run over a large project.

See how much is left

Usage is per account, not per window or per machine. Two editors and the CLI signed in to the same account all draw on the same allowance.

The Usage page

AstraCode Settings > Usage has these parts, top to bottom:

PartWhat it shows or does
Current planYour plan's name and when the allowance resets.
UpgradeOpens the upgrade page on the site. Not shown on the highest plans.
Plan usage this monthA meter of how much of the allowance has gone. When it is full, the page says so and offers the ways on.
Additional usageWhether work carries on past your allowance, with Turn on, Turn off or Add a card. See below.
Monthly limitThe most additional usage may add up to in one period, or No limit. See below.

If the page cannot load your plan it says Could not reach AstraCode to load your plan. It fills in by itself once AstraCode answers. Signed out, it says Sign in to see your plan and usage.

When you are running low

Before the allowance runs out, the chat shows a warning card once, saying most of your plan is used and when it resets. Its button is Upgrade (or Upgrade to a named plan) when upgrading is the way on, otherwise View usage. Nothing stops at this point; it is a warning.

When the allowance is used up

A message you send after that gets a card titled Usage limit reached: You've used all of your plan for this period., followed by when it resets. The buttons depend on your plan and settings, with the one that gets you working again soonest first:

ButtonWhat it does
Upgrade to a plan, or UpgradeOpens the upgrade page. A new plan starts its allowance straight away.
Turn on additional usageTurns on additional usage, so work carries on and is billed to your card. Needs a card on file.
View usageOpens AstraCode Settings > Usage.
Contact supportOpens the contact page.

On a team plan you may instead read Ask your team's admin to upgrade or turn on additional usage. Only an admin can change the team's plan. If additional usage is already on, you see an information card instead: you can keep working, and the extra is billed separately until your plan resets.

Waiting is always an option: the allowance comes back on the reset date shown on the card and on the Usage page.

Additional usage

Additional usage lets work continue past your plan's allowance. It is billed at your plan's rate to the card on file at the end of each billing period. With it off, work stops when the allowance is used up and nothing is billed beyond your subscription. It is available on paid plans only; on the Free and Student plans the Usage page shows On paid plans.

Turn it on

  1. Open AstraCode Settings > Usage.
  2. Under Additional usage, choose Turn on. If the page says Needs a card on file, choose Add a card instead, add one in Billing on the site, then come back and choose Turn on.
  3. Optionally set a Monthly limit below it, so additional usage cannot run past an amount you choose.

To stop it, choose Turn off in the same place.

The monthly spending limit

Monthly limit is a list of fixed amounts plus No limit. Once additional usage reaches your limit, work stops again and the chat shows Additional usage limit reached: You've reached the spending limit you set for additional usage. Its button, Raise the limit, opens the Usage page so you can pick a higher one. The limit resets with your billing period.

Separately, a request can stop with Stopped at your spending cap. That is a safety cap rather than your plan's allowance; raise it on the Usage page if that is what you want.

Upgrade or manage your plan

Other limits you may meet

CardWhat it means
Going too fastA short rate limit, not your allowance. It clears on its own, and nothing was charged.
Inline completions are paused until tomorrowTab completion has a daily limit of its own. Chat and the agent still work. It resets at midnight UTC.
You have used this month's free allowanceThe Free plan's allowance is used. Upgrading starts a new month straight away.

Web searches the agent runs count against your allowance like any other work. To turn them off, see Web search and reading pages.

With your own key

Requests that use your own provider key are billed by that provider to your key and are not counted against your AstraCode allowance. See Bring your own key.

If something goes wrong

Every usage, billing and connection card, with its fix, is in Usage, billing and network errors.

← CLI reference Bring your own key →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference