billing - floo

Manage billing, spending limits, and plan upgrades.

spend-cap get

Show current spend cap and usage.

floo billing spend-cap get

  Spend cap: $50.00/month
  Current spend: $12.34

When the cap is exceeded the command adds a warning that deploys are blocked.

JSON output

{
  "success": true,
  "data": {
    "spend_cap_cents": 5000,
    "current_period_spend_cents": 1234,
    "spend_cap_exceeded": false
  }
}

Values are in cents. spend_cap_cents is null when no cap is set. Use floo billing usage for the plan, the plan maximum, and the per-app breakdown.

spend-cap set

Set monthly spend cap in dollars. Use 0 to remove the cap (no limit).

floo billing spend-cap set 50

Arguments

Argument	Description
`AMOUNT`	Monthly spend cap in dollars, from $0 to$ 1,000,000. Use `0` to remove the cap.

Examples

# Set a $50/month cap
floo billing spend-cap set 50

# Remove spend cap
floo billing spend-cap set 0

# Agent workflow: set cap and confirm
floo billing spend-cap set 100 --json 2>/dev/null | jq -r '.data.spend_cap'

JSON output

{
  "success": true,
  "data": {
    "spend_cap": 5000,
    "policy": "freeze_new_spend"
  }
}

spend_cap is in cents and is null after set 0. policy is the budget-protection mode floo applies when spend reaches the cap: alerts_only, freeze_new_spend, hard_stop, or off when no cap is set. The CLI has no flag for the mode: setting a cap keeps the org’s current mode, or applies freeze_new_spend when protection was off. Change the mode in the dashboard. See Billing and spend caps for what each mode does.

upgrade

Open Stripe billing portal to upgrade plan.

floo billing upgrade

Flags

Flag	Description
`--plan paygo\|team`	Target self-serve plan

Plans

Plan	Price
Pay as you go	$0 monthly commitment; usage billed monthly
Team	$250/mo, including 250 floo credits
Enterprise	Custom pricing

Examples

# Open upgrade portal (interactive plan selection)
floo billing upgrade

# Upgrade to a specific plan
floo billing upgrade --plan paygo

JSON output

For new subscriptions (opens Stripe checkout):

{
  "success": true,
  "data": {
    "url": "https://billing.stripe.com/session/..."
  }
}

Omit --plan to open the billing portal for an existing subscription. Plan changes take effect at a billing-period boundary so the period keeps one immutable offer and allowance.

usage

Show current plan, usage, and spend cap with visual progress bar.

floo billing usage

Plan: Pay as you go ($0 commitment)
floo credits included: 0.00/month
Compute used: $12.34 (Current month)
Spend cap: $50.00/month
Usage: 25% of cap
████████░░░░░░░░░░░░░░░░░░░░░░  25%

Flags

Flag	Description	Default
`--period PERIOD` / `-p PERIOD`	Compute-cost window: `current_month`, `last_month`, or `last_7d`	`current_month`

One floo credit equals $1 of metered app usage. Pay as you go includes 0 credits and Team includes 250 credits each month.

Warm instance cost

Web and API services scale to zero when min_instances is omitted on every plan and in every environment, including production. A warm instance bills continuously, even while idle. See Pricing for what the default shapes cost under the current rate policy, and Scaling and availability for the arithmetic and the verification commands. Set min_instances = 1 or higher in floo.app.toml to keep instances warm.

JSON output

{
  "success": true,
  "data": {
    "plan": "paygo",
    "spend_cap_cents": 5000,
    "max_spend_cap_cents": 100000,
    "period_spend_cents": 1234,
    "spend_cap_exceeded": false
  }
}

contact

Print enterprise contact info.

floo billing contact

Enterprise & custom plans: sales@getfloo.com
Subject: Enterprise inquiry

JSON output

{
  "success": true,
  "data": {
    "email": "sales@getfloo.com",
    "subject": "Enterprise inquiry"
  }
}

Errors

Code	Meaning
`NOT_AUTHENTICATED`	Run `floo auth login` first
`INVALID_AMOUNT`	Spend cap must be between $0 and$ 1,000,000
`SPEND_CAP_EXCEEDS_PLAN_LIMIT`	The cap is above your plan’s maximum. Upgrade to raise it

​spend-cap get

​JSON output

​spend-cap set

​Arguments

​Examples

​JSON output

​upgrade

​Flags

​Plans

​Examples

​JSON output

​usage

​Flags

​Warm instance cost

​JSON output

​contact

​JSON output

​Errors

spend-cap get

JSON output

spend-cap set

Arguments

Examples

JSON output

upgrade

Flags

Plans

Examples

JSON output

usage

Flags

Warm instance cost

JSON output

contact

JSON output

Errors