Dome Systems

dome billing

Review organization plan status, usage, seats, invoices, and plan changes

dome billing manages organization billing. All commands require billing.manage and accept --org-id to override the active context's organization. Card capture completes in the dashboard.

Command
Show statusdome billing status
List plansdome billing plans
Change plandome billing change-plan <sku>
Cancel plandome billing cancel
Resume plandome billing resume
Show seatsdome billing seats
Set seatsdome billing seats set <count>
Show usagedome billing usage
List invoicesdome billing invoices
Show contactdome billing contact
Set contactdome billing contact set
List payment methodsdome billing payment-methods
Add payment methoddome billing payment-methods add
Set default payment methoddome billing payment-methods set-default <payment-method-id>

dome usage-caps shows free-tier allowances for the active workspace.

Plan

Show status

dome billing status

Show the active plan and interval, subscription status, renewal dates, default payment method, any scheduled plan change, and any resources over the current tier's caps.

List plans

dome billing plans

List the self-serve plans and their monthly and annual prices, plus enterprise plans that require contacting sales. Per-seat plans show a per-user price. Pass --json for full per-SKU limits and features.

Change plan

dome billing change-plan <sku> --interval monthly --seats 5 --dry-run
dome billing change-plan <sku> --interval annual --seats 10

Change the organization's plan.

FlagTypeRequiredDescription
--intervalmonthly | annualNoBilling interval
--seatsint32NoPurchased seats on a per-seat plan; 0 keeps the assigned-seat count
--dry-runboolNoPreview the charge, credit, and scheduling without applying the change

An upgrade applies immediately and bills a full period up front; time already paid on the old plan returns as an account credit toward upcoming invoices rather than reducing today's charge. A downgrade is scheduled for the end of the current term and is not refunded, and it is blocked while resources exceed the target plan's caps.

To move seats on the plan you already have, use seats set instead.

Cancel plan

dome billing cancel

Schedule cancellation of the paid plan. The plan stays active until the end of the current billing period, then reverts to free.

FlagTypeRequiredDescription
--yesboolNoSkip the confirmation prompt

Resume plan

dome billing resume

Reverse a scheduled cancellation before the current term ends. The existing plan and billing cadence continue, and nothing is charged.

Seats

Show seats

dome billing seats

Show purchased and used seats. Used counts the distinct role holders across all workspaces; purchased is what the organization pays for on a per-seat plan.

Set seats

dome billing seats set 12 --dry-run
dome billing seats set 12

Set the absolute purchased-seat count on the current per-seat plan without changing its SKU or billing interval.

FlagTypeRequiredDescription
--dry-runboolNoPreview the target, recurring total, and whether the change is deferred

An increase applies immediately and is billed now, prorated for the remainder of the current period. A reduction is scheduled for the period end and does not remove access early. The target cannot be lower than the number of assigned seats. Setting the count back to today's value cancels a pending reduction, and each new request replaces any earlier one.

Usage and invoices

Show usage

dome billing usage

Show the usage-based charges accruing in the current billing period, broken down by meter and by tenant.

Usage meters governed actions: every tool call and model call that clears authentication and quotas, whether allowed or denied. Tool calls are billed per call and model calls by tokens. The plan fee and seats are billed separately and are not included here.

List invoices

dome billing invoices

List invoice history with each invoice's date, amount, status, and hosted URL.

FlagTypeDefaultDescription
--limitint3220Maximum invoices to return

Billing contact

Show contact

dome billing contact

Show the current billing contact and address.

Set contact

dome billing contact set --email billing@example.com

Update the billing contact. Pass at least one flag; only the fields you pass change.

FlagTypeDescription
--namestringContact name
--emailstringContact email
--line1stringAddress line 1
--line2stringAddress line 2
--citystringCity
--statestringState or province
--postal-codestringPostal or ZIP code
--countrystringCountry as an ISO 3166-1 alpha-2 code, such as US

Payment methods

Aliases: payment-method, pm.

List payment methods

dome billing payment-methods

List saved cards with their brand, last four digits, expiration, and which is the default.

Add payment method

dome billing payment-methods add

Start a Stripe SetupIntent and print its publishable key and client secret. Card entry completes in the browser, so the card number never reaches Dome. Finish in the dashboard under Billing → Payment methods.

Set default payment method

dome billing payment-methods set-default <payment-method-id>

Make a saved payment method the default. IDs come from payment-methods.

Next steps

On this page

Was this page helpful?