Billing & Credits

The ivybloom CLI is the scriptable surface for the platform, and billing commands let you track usage, manage subscriptions, and monitor credit spending without leaving the command line. Reach for them when a scripted workflow needs to check its own cost footprint — computational jobs consume credits based on the tool and AI model used — or when you want to manage billing programmatically rather than through the web interface. They give your automation visibility into its spend; for the full command surface, see the CLI overview.

Billing & Credits

Track usage, manage subscriptions, and monitor credit spending from the command line.

Overview

.bloom* uses a credit-based system for computational jobs. Credits are consumed based on the tool used and the AI model selected. The CLI provides full billing management without needing the web interface.

Credit Balance

Check Current Balance

ivybloom credits summary

BALANCE    DAILY USED    DAILY LIMIT    MONTHLY USED    MONTHLY LIMIT
1,250      87            500            312             5,000

Credit Statistics

ivybloom credits stats

Aggregated usage statistics broken down by tool and time period.

Usage Tracking

Credit History

ivybloom credits history

View a chronological log of credit transactions (charges and additions).

Usage Trends

ivybloom credits trends

Shows usage trends and projections based on your recent activity. Helpful for estimating when credits will run out.

Subscription Management

View Current Plan

ivybloom billing status

Shows your current plan, renewal date, and included credits.

List Available Plans

ivybloom billing plans

Compare available subscription tiers and their included credits.

Token Balance

ivybloom billing tokens

Check your current token balance (tokens are the billing unit for AI model usage).

Billing Portal

ivybloom billing portal

Opens the billing portal in your browser for payment method management, plan changes, and invoice downloads.

Invoices

ivybloom billing invoices
ivybloom billing invoices --limit 5

List billing invoices with pagination.

Spending Alerts

View Alert Settings

ivybloom credits alerts show

Set Alert Thresholds

# Alert when daily spending exceeds 100 credits
ivybloom credits alerts set --type daily_limit --threshold 100

# Alert when monthly spending exceeds 1000 credits
ivybloom credits alerts set --type monthly_limit --threshold 1000

Alerts notify you via email and in the TUI when thresholds are reached.

AI Model Pricing

Model calls draw credits by one rule for every model, spelled out in plans and tiers.

View available models:

ivybloom config models list
ivybloom config models list --available

Usage Export

Export credit usage data for analysis or accounting:

# Export as JSON
ivybloom credits export --format json

# Export as CSV (for spreadsheets)
ivybloom credits export --format csv

Account Usage

Overview

ivybloom account usage

Shows high-level usage statistics including total jobs run, API calls, and storage used.

Account Info

ivybloom account info

Detailed account information including plan details, usage limits, and current quotas.

CI/CD Cost Tracking

For automated pipelines, use agent mode to get structured billing data:

# Check credits before submitting expensive jobs
BALANCE=$(ivybloom credits summary --agent | jq -r '.data.balance')
if [ "$BALANCE" -gt 100 ]; then
  ivybloom batch submit screen.yaml
fi

Read next

• Configuration — BYOK setup to use your own API keys
• Organizations — Team billing and shared usage
• Batch Processing — Estimate costs for batch jobs
• Commands Reference — Full command documentation