Billing

Route: /team?view=billing (Team → Billing; the old /billing link opens it)

Scenario: It’s the 20th of the month. You get an email at 50% of your diagnosis quota, then again at 80%. You want to know when you’ll hit the wall, what your projected bill is, and how to cap spend, without logging into Stripe.

A diagnosis is one completed plain-English root cause — the moment Mushi Mushi finishes reading a report and can hand your editor a paste-ready fix prompt. Noise filtered out or duplicate reports collapsed to one row do not count. You pay for comprehension, not volume.

Everything you need to manage your Mushi Mushi subscription is in this view, on three tabs: Overview (your project card with usage, controls and invoices), Plans (plan comparison) and Support (open a ticket).

Reading your usage card

Each project has a billing card. The key element is the usage bar:


Diagnoses used: ████████░░░░  85%  (850 / 1,000)

Below the bar you will see:

Element	What it tells you
Forecast chip	At current pace, when you’ll hit your included quota, or “Quota resets in N days”
Projected cost	Estimated monthly bill at current pace (paid plans with overage; never shown on a complimentary account)

What happens at 100%?

Free: New reports are captured but not diagnosed until the period resets.
Builder / Studio (monthly): Overage continues ($0.03 a diagnosis on Builder, $0.02 on Studio) until your spend cap pauses Stage-2 classification. No reports are lost.
Builder / Studio (annual): No overage. Stage-2 classification pauses at the included diagnoses until the next calendar month. No reports are lost.

Usage breakdown

Meter	What it measures
Diagnoses	Completed Stage-2 classifications this billing period, against the plan’s allowance
Reports	Reports received this period (no report limit on current plans)
Seats	Members plus pending invitations, against the plan’s seats
Spend cap	Your hard USD ceiling on overage, or Not set
Fixes merged	Fix PRs from Mushi Mushi merged this period, from any agent

The card also shows Classifier tokens for the period. A past_due subscription shows a banner asking you to update your card.

The 30-day sparkline shows daily report volume, useful for spotting a spike that will push diagnoses over quota.

Predictability controls

On each paid project card, Predictability controls let you:

Monthly spend cap (USD): override the plan default ($50 Builder, $200 Studio). Diagnoses pause gracefully at the cap.
Usage alert email: where 50% / 80% / 100% quota alerts are sent (defaults to project owner).

Both settings save immediately via the Billing API. Leave the cap blank to revert to the plan default; leave the email blank to use the owner address.

Alerts are deduplicated: at most one email per threshold per billing month. The usage-alerts cron runs hourly.

Apps on your plan

A plan sets how many apps your team watches: Free 1, Builder 3, Studio 10, Enterprise no limit. Creating one more app than the plan allows stops with a message that names your plan, how many apps the team has, and the plan that fits, plus a See plans button that opens the Plans tab. Apps you already have keep working.

The Plans tab compares Free, Builder, Studio and Enterprise by apps, diagnoses, overage and history, and shows whether your team’s apps and this period’s diagnoses fit each plan.

Upgrading your plan

Click Upgrade on the project card.
Pick Monthly or Annual (about two months free), then Select the plan you want (Builder $29/month or $290/year; Studio $79/month or $790/year).
Complete payment in Stripe Checkout.
Stripe sends you back to Billing, which shows the new plan as soon as Stripe confirms the payment.

Changing plan

A project that already pays switches in the console, not in Checkout:

Click Change plan on the project card.
Choose Builder or Studio, monthly or annual. The current choice shows as Current plan.
The dialog shows what Stripe charges now (or credits) for the prorated difference. Click Confirm change.

The change applies immediately. Moving between monthly and annual starts a new billing period that day. If the card is declined, nothing changes. Annual plans have no overage and stop at the included diagnoses each month. Enterprise is arranged with our team: use Contact us on the Plans tab.

Managing payment and invoices

Click Manage to open the Stripe Billing Portal. Plan changes happen in Change plan above; Stripe’s portal cannot switch a subscription that has metered usage. Use the portal for:

Updating your credit card
Viewing upcoming invoices
Cancelling a subscription
Downloading invoice PDFs

The Invoices table on this page shows recent hosted invoice links.

CLI parity


mushi usage              # diagnoses used / limit this period
mushi billing status     # plan, usage, cap, overage rate
mushi billing cap        # show current spend cap
mushi billing cap 100    # set $100/mo hard cap
mushi billing cap 0      # clear override → plan default

Public pricing: plan table, estimator, example bills, FAQ
Self-hosting: unlimited diagnoses with your own LLM key
Team: the page this view belongs to