AddThisFeature

AI Usage Quotas

Limit how much AI work a plan or workspace can do, and show what is left.

involved Developer Experience

What it adds

Countable allowances for AI messages, runs, documents, or tokens, enforced per plan and workspace with a defined reset period.

What your agent is told to do

5
  1. 1

    Identify the units the product actually sells on: messages, runs, processed documents, or tokens. Pick as few as possible and define each one precisely before writing any enforcement.

  2. 2

    Enforce every quota on the server at the point the work is dispatched. Client-side counters and hidden buttons are presentation, not enforcement.

  3. 3

    Decide and document whether a run that failed, was cancelled, or returned a refusal consumes allowance, and apply that decision consistently across every AI surface.

  4. 4

    Support a shared workspace pool with optional per-member caps, so one member cannot drain the whole allowance in an afternoon.

  5. 5

    AI Cost Budgets owns money and provider spend. This entry owns countable units and plan entitlements. Reuse the same dispatch interception point but do not derive one limit from the other.

Edge cases it handles

8
  • Any check performed only in the interface can be bypassed by calling the endpoint directly. The dispatch path must re-check the quota server-side every time, including for background and scheduled runs.
  • Failed, cancelled, and refused runs need an explicit rule. Charging for a run the model refused feels like theft; charging for nothing at all invites retry loops as a way around the limit.
  • A shared workspace pool without a per-member cap lets one person exhaust the month for everyone. Support both, and make the interaction between them explicit in the interface.
  • Reset periods must be anchored to a stated time zone and to the billing anniversary rather than a server-local midnight, or usage will reset at a time that makes no sense to the customer.
  • Token counts are estimates until the provider reports actuals. Show remaining usage in the honest unit and never present an estimate with a precision it does not have.
  • Concurrent requests near the limit must not all be admitted. Decrement atomically at dispatch rather than reading a count and writing it back.
  • A plan downgrade mid-period must not produce a negative balance or retroactively invalidate work already done.
  • When a quota is exhausted, the user needs to know which unit ran out, when it resets, and who in the workspace can raise it. A generic refusal produces a support ticket.

Definition of done

9
  • Quotas are enforced server-side on every dispatch path, including background and scheduled runs.
  • The treatment of failed, cancelled, and refused runs is defined and applied uniformly.
  • Workspace pools and per-member caps both exist and their interaction is visible to the user.
  • Reset periods use a stated time zone and align to the billing anniversary.
  • Remaining usage is displayed in honest units with no false precision on estimates.
  • Concurrent requests at the limit cannot exceed the allowance.
  • An exhausted quota tells the user what ran out, when it resets, and who can raise it.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.