Account & Billing

Manage your BoostOS subscription, check entitlements, and access the billing portal — all from the CLI.

Prerequisites

You must be signed in before running account commands. Run boost auth login first if you haven't already. See Authentication for details.

Check your account status

boost account status

Returns your current subscription, scope, and feature entitlements.

Example output:

{
  "effective": {
    "id": "sub_abc123",
    "status": "active",
    "scope": "user",
    "plan": "pro"
  },
  "scopes": {
    "user": [
      { "id": "sub_abc123", "status": "active", "plan": "pro" }
    ],
    "organization": []
  },
  "entitlements": {
    "llmEnabled": true,
    "multiAgentEnabled": true,
    "maxAgents": 10
  }
}

Understanding the response

Field	Description
effective	The active subscription used for your current session. null if none found.
scopes.user	Subscriptions tied to your personal account.
scopes.organization	Subscriptions tied to your organization.
entitlements	Feature flags that control what the CLI can do.

Common statuses

Status	Meaning
active	Paid plan is active — full access to all entitled features.
trialing	Free trial is active — all features are available until the trial ends.
null	No subscription found. Run boost account checkout user to start one.

Start a checkout

Purchase a personal subscription:

boost account checkout user

Purchase an organization subscription:

boost account checkout organization

Both commands open a Stripe checkout session in your browser. Once payment completes, run boost account status to verify your new plan.

Manage your subscription

Open the billing portal to update payment methods, change plans, or cancel:

boost account manage user

For organization billing:

boost account manage organization

Troubleshooting

effective: null — no active subscription You don't have an active plan. Start one with boost account checkout user.

Unauthorized error Your session has expired. Run boost auth login to sign in again.

Subscription active but features disabled Try refreshing your session with boost auth refresh, then check boost account status again.