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

# Plans, Pricing & Usage

> Plan tiers, compute units, usage tracking, and billing management.

## Plans

<CardGroup cols={3}>
  <Card title="Free" icon="seedling">
    **\$0 / month**

    * 25 CU per week
    * Up to 20 active tasks
    * Community support
  </Card>

  <Card title="Pro" icon="bolt">
    **\$50 / month**

    * 100 CU per week
    * Up to 20 active tasks
    * Priority support, private repos, team collaboration
  </Card>

  <Card title="Max" icon="rocket">
    **\$100 / month**

    * 500 CU per week (base)
    * Up to 40 active tasks (scales with multiplier)
    * Adjustable capacity multiplier (up to 500x)
    * Advanced analytics
  </Card>
</CardGroup>

<Note>
  During the alpha period, all plans include a promotional CU boost. Your effective CU allocation is shown in **Settings → Usage**.
</Note>

### Feature Comparison

| Feature                 | Free      | Pro      | Max          |
| ----------------------- | --------- | -------- | ------------ |
| **CU per week**         | 25        | 100      | 500 (base)   |
| **Active tasks**        | 20        | 20       | 40+ (scales) |
| **Private repos**       | —         | Yes      | Yes          |
| **Team collaboration**  | —         | Yes      | Yes          |
| **Capacity multiplier** | —         | —        | 1x–500x      |
| **Advanced analytics**  | —         | —        | Yes          |
| **Support**             | Community | Priority | Priority     |

### Annual Billing

Save **17%** (two months free) with annual billing:

| Plan    | Monthly  | Annual               | You save |
| ------- | -------- | -------------------- | -------- |
| **Pro** | \$50/mo  | $499/yr (~$41.58/mo) | \$101/yr |
| **Max** | \$100/mo | $999/yr (~$83.25/mo) | \$201/yr |

### Max Plan Multiplier

The Max plan includes an adjustable **capacity multiplier** that scales your CU allocation and active task limit linearly:

* **1x** (default) — 500 CU/week, 40 active tasks
* **2x** — 1,000 CU/week, 80 active tasks
* **Up to 500x** — 250,000 CU/week

Adjust anytime from the Plan settings page. Changes take effect immediately with prorated billing.

### Enterprise

For custom CU allocations, dedicated support, or compliance requirements, reach out at [whim.run](https://www.whim.run).

***

## Compute Units (CUs)

CUs are Whim's unified billing currency. Today, most teams use CUs for **container runtime** only because Claude and Codex run on your own subscriptions. **CCR/OpenRouter token billing is coming soon.**

### What is a CU?

| Resource              | 1 CU ≈                                        |
| --------------------- | --------------------------------------------- |
| **Container runtime** | 30 minutes at base config (1 vCPU + 1 GB RAM) |
| **Input tokens**      | \~14,000 tokens                               |
| **Output tokens**     | \~2,800 tokens                                |
| **USD cost**          | \~\$0.044                                     |

<Info>
  Higher machine profiles consume CUs proportionally faster.
</Info>

### How CUs Are Calculated

**Container CU** — 1 CU per 30 minutes of active container time. Pausing or sleeping a task stops accrual.

**Token CU** — metered by tokens processed when token-billed providers are enabled. More expensive models consume CUs faster.

**Total CU** = container CU + token CU (when token billing applies).

### CU Allocation

CUs are allocated **weekly** and reset every 7 days from your subscription anchor:

| Plan | CU per week                        |
| ---- | ---------------------------------- |
| Free | 25                                 |
| Pro  | 100                                |
| Max  | 500 (base, scales with multiplier) |

<Info>
  Unused CUs do not roll over. Each week starts fresh.
</Info>

### Warning Thresholds

| Level    | Threshold   | Indicator           |
| -------- | ----------- | ------------------- |
| Normal   | \< 80% used | Green               |
| Warning  | 80% used    | Yellow              |
| Critical | 90% used    | Red                 |
| Depleted | 100% used   | Tasks may be paused |

<Warning>
  When fully depleted, a grace period lets running tasks finish briefly. You can't start new tasks until your period resets or you upgrade.
</Warning>

### Reserved Machine CUs

Warm containers kept ready for instant task starts consume **3 CU per week** per reserved machine. Default reserves by plan: Free (3), Pro (5), Max (10). Maximum 20 per tracked branch.

### Bonus CU

Bonus CU from promotions or credits is tracked separately and used after your regular weekly allocation is consumed.

***

## Usage Dashboard

Available in **Settings → Usage** with a real-time view of your team's CU consumption.

### CU Balance

Shows your current allocation, remaining balance, a color-coded progress bar, and the current period window (start/end dates).

### Per-Task Breakdown

| Column           | Description                               |
| ---------------- | ----------------------------------------- |
| **Task**         | Name and display ID                       |
| **Status**       | Running, Completed, Sleeping, or Archived |
| **Duration**     | Container runtime                         |
| **Container CU** | Runtime consumption                       |
| **Token CU**     | AI model token consumption                |
| **Total CU**     | Combined total                            |
| **Started**      | Launch time                               |

***

## Payment & Invoices

Whim uses **Stripe** for payment processing. Manage your payment methods via **Settings → Plan → Manage Billing**, which opens the Stripe portal where you can:

* Add or update credit/debit cards
* View payment history and download invoices
* Update billing information

Invoices are generated automatically for subscription charges, proration charges (mid-cycle upgrades), and proration credits (unused time after plan changes).

### Changing Plans

1. Go to **Settings → Plan**.
2. Select your desired plan and billing period.
3. For Max, adjust the capacity multiplier if needed.
4. Review the **proration preview** showing credits, charges, and net amount.
5. Confirm.

<Tip>
  Upgrades apply immediately with a fresh CU period. Downgrades take effect at the end of the current billing period.
</Tip>
