Billing & usage

Read your plan and credits

The organization's current plan, the available plans, and the live usage-credit balance.

spaceboy billing              # current plan + available plans

Upgrade the plan

Mints a Stripe checkout link for the target plan. The CLI's --wait polls until the plan change lands.

spaceboy billing upgrade pro --interval year [--wait]

Top up usage credits

Buy prepaid usage credits: mint a checkout link, or — with a saved card — charge directly with no browser round-trip, the shape agents use to unblock themselves.

spaceboy topup 20                # checkout link
spaceboy topup 20 --charge       # charge the saved card now
spaceboy topup 20 --wait         # watch for the credit to land

Out-of-credits errors carry your balance and top-up bounds in extensions.usage, so integrations can self-serve the exact remediation.