Billing & usage

Read your billing and balance

The organization's published quantities, the purchasable offerings, and the live balance.

spaceboy billing              # published items + offerings

Buy an offering

Mints a Stripe checkout link for a site slot, an app slot, or the Enterprise unlock. When a live subscription can absorb the change, mode SWAPPED means it was applied in place — no redirect needed.

spaceboy billing buy business --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.