> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubic.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Flex capacity

> How cubic bills extra reviewed-line capacity after your included usage runs out.

Flex capacity keeps GitHub PR AI reviews running after your workspace uses its included reviewed-line capacity. cubic buys extra reviewed-line capacity, in top-ups of the size you choose, only when a review would otherwise be paused. A monthly spend limit is optional.

Flex capacity is available on paid workspaces billed through Stripe. Admins manage it from **Settings → Billing** or **Settings → Usage** by choosing a top-up size and, optionally, a monthly spend limit.

## How flex capacity works

Flex capacity turns a reviewed-line usage block into an automatic one-off charge:

1. Your workspace uses its included reviewed-line capacity for the billing period.
2. A new GitHub PR review would otherwise pause because the workspace is over its monthly limit.
3. cubic checks your flex capacity setting and any monthly spend limit.
4. If the needed capacity fits under the limit, or you set no limit, cubic charges the saved payment method immediately.
5. After payment succeeds, cubic adds the extra reviewed-line capacity for the current billing period and continues the review.

Flex capacity applies only to GitHub PR AI review usage. CLI/local reviews, codebase scans, daily scans, wikis, and cubic coding agents use separate limits.

## Pricing

Flex capacity costs **\$20 per 10,000 extra reviewed lines**.

| Item | Amount |
| - | - |
| Billing unit | 10,000 extra reviewed lines |
| Price | \$20 per 10,000 lines |
| Top-up sizes | 40,000, 100,000 or 500,000 lines, or any multiple of 10,000 |
| Billing timing | Charged immediately when capacity is needed |
| Availability | Current billing period only |

The price is the same for Team, Pro, and Max workspaces, and the same for monthly and annual subscriptions. Flex capacity is separate from your seat subscription; it appears as a one-off invoice charge when cubic adds capacity.

## Example charges

You choose a preferred top-up size in multiples of 10,000 lines. cubic buys enough blocks to cover the current overage, and it never buys a partial block.

For a preferred top-up size of 20,000 lines:

| Current overage | Preferred top-ups | Charge | Extra capacity granted |
| - | - | - | - |
| 4,000 reviewed lines | 1 | \$40 | 20,000 reviewed lines |
| 15,000 reviewed lines | 1 | \$40 | 20,000 reviewed lines |
| 25,000 reviewed lines | 2 | \$80 | 40,000 reviewed lines |

If a review is 25,000 lines over the included limit, cubic needs two blocks of 20,000 lines each.

If your remaining monthly flex limit is less than the price for a preferred top-up, then cubic will buy the smallest amount that fits under the limit. For example, if your remaining limit is \$30, but your preferred top-up is 20,000 lines for \$40, and the review needs 5,000 lines, cubic will buy a 10,000-line block for \$20. If a review needs 40,000 lines, cubic will buy nothing because the remaining \$30 cannot fund the required 40,000 lines.

## Spend limits

Flex capacity has no spend limit by default. Without one, cubic emails workspace admins once flex spend reaches \$200 in a billing period. A monthly spend limit is the most cubic can spend on flex capacity during one billing period. The setting is a hard stop: reviews can continue while the needed flex purchase fits under the limit, and reviews pause once the next needed purchase would exceed the limit.

For example, a \$60 monthly spend limit can buy up to 30,000 extra reviewed lines during the current billing period. If your workspace has already spent \$40 and the next review needs 5,000 lines, cubic can buy a smaller 10,000-line top-up for the remaining \$20. If the review needs 15,000 lines, cubic buys nothing because the remaining \$20 cannot fund the required 20,000 lines.

Admins can set, change, or remove the spend limit from the **Flex capacity** row in **Settings → Billing**, or from **Settings → Usage**. **Turn off flex** stops future purchases. Extra capacity already bought during the billing period remains available until the period ends.

## Payment behavior

Flex capacity is granted only after payment succeeds. If the payment method is declined, cubic does not grant the extra capacity and reviews stay paused at the current limit.

Some cards require extra authentication, such as 3D Secure. When that happens, cubic emails workspace admins a link to the installation's Billing settings. The settings page provides the secure Stripe invoice link, and cubic grants the extra capacity after Stripe confirms the payment.

A failed flex capacity payment prevents cubic from creating another flex invoice for the same capacity. cubic retries the existing open invoice when another review needs capacity, waiting longer after each declined charge (from one hour up to a day). Workspace admins can pay it sooner from the installation's Billing settings.

## How to turn it on

Admins can enable flex capacity from the billing settings:

1. Open **Settings → Billing**.
2. Next to **Flex capacity**, select **Edit**.
3. Choose a top-up size: 40,000, 100,000 or 500,000 lines, or **Custom** for any multiple of 10,000.
4. To cap spending, select **Set a monthly limit**. Without a limit, cubic keeps buying top-ups as reviews need them.
5. Select **Turn on flex**, or **Save** if flex is already on.

On **Settings → Usage**, **Add flex capacity** on the Flex row opens the same dialog. While a flex payment is pending or has failed, admins see **View payment** instead, which opens **Settings → Billing** so they can complete the payment. Members see a note to ask an admin.

The setting takes effect for future reviews. If reviews are already paused because your workspace is over the reviewed-line limit, turning flex on, or raising or removing the limit, lets cubic buy the needed extra capacity and resume reviews.

## How to monitor usage

Open **Settings → Usage** to see your reviewed-line usage and reset date for the current billing period, split into included lines and flex capacity. While flex capacity is on, Usage and Billing both show any monthly limit and this period's flex spend.

Flex capacity resets with your billing period. Unused extra capacity does not roll over.

## FAQ

<AccordionGroup>
  <Accordion title="Does flex capacity replace seats?">
    No. Seats still determine your included reviewed-line allowance and who has paid AI review access. Flex capacity covers temporary overages after your included reviewed-line capacity runs out.
  </Accordion>

  <Accordion title="Does flex capacity charge upfront?">
    No. cubic charges flex capacity only when a review needs extra capacity and, if you set a monthly spend limit, the purchase fits under it.
  </Accordion>

  <Accordion title="Can cubic spend past my monthly limit?">
    No. The spend limit is a hard cap. If the next required purchase would exceed the limit, cubic buys nothing and reviews stay paused until you raise or remove the limit or the billing period resets.
  </Accordion>

  <Accordion title="Why did cubic buy more capacity than one PR needed?">
    cubic buys your preferred top-up size in 10,000-line units. It can combine multiple preferred top-ups when the current overage needs more capacity.
  </Accordion>

  <Accordion title="What happens if I turn flex capacity off?">
    cubic stops making future flex capacity purchases. Extra capacity already paid for during the current billing period remains available until the period resets.
  </Accordion>

  <Accordion title="What happens when my billing period resets?">
    Your included reviewed-line allowance resets, flex spend returns to \$0 for the new period, and any unused extra flex capacity from the previous period expires.
  </Accordion>

  <Accordion title="Does flex capacity apply to public repositories?">
    Flex capacity applies to your paid workspace's GitHub PR AI review usage. Public repositories may also be subject to separate fair-use and abuse-protection limits, which flex capacity does not override.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.