billing

Manage billing, spending limits, and plan upgrades.

spend-cap get

Show current spend cap and usage.

floo billing spend-cap get

JSON output

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

Value is in cents. spend_cap is null when no cap is set. Use floo billing usage for current period spend and cap status.

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. Range: $0 --$ 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
  }
}

Value is in cents. Returns null when cap is removed (set to 0).

upgrade

Open Stripe billing portal to upgrade plan.

floo billing upgrade

Flags

Flag	Description
`--plan hobby\|pro\|team`	Target plan

Plans

Plan	Price
Free	$0/mo
Hobby	$5/mo
Pro	$20/mo
Team	$200/mo
Enterprise	Custom pricing

Examples

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

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

JSON output

For new subscriptions (opens Stripe checkout):

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

For instant upgrades (existing subscription):

{
  "success": true,
  "data": {
    "upgraded": true,
    "plan": "pro"
  }
}

usage

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

floo billing usage

Plan: Pro ($20/mo)
Included compute: 20 credits / month
Current spend: 12.34 credits
Spend cap: 50 credits / 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 compute credit equals $1 of metered app usage. Plan tiers include 5 lifetime credits (Free), 5 / month (Hobby), 20 / month (Pro), and 200 / month (Team).

JSON output

{
  "success": true,
  "data": {
    "plan": "pro",
    "spend_cap_cents": 5000,
    "max_spend_cap_cents": 100000,
    "current_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

CLI

Config

spend-cap get

JSON output

spend-cap set

Arguments

Examples

JSON output

upgrade

Flags

Plans

Examples

JSON output

usage

Flags

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

​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

JSON output

contact

JSON output

Errors