Skip to main content

​
Billing & Budgets

Caged charges for two things: compute time and LLM tokens (when using Caged-provided models).

​
Pricing

​
Compute

ResourceRate
vCPU$0.01/hour per core
Memory$0.005/hour per GB
Disk$0.001/hour per GB
Network egress$0.01/GB
Paused sandboxes incur no compute charges.

​
Plans

PlanMonthlyIncluded ComputeConcurrent Sandboxes
Free$010 hours2
Pro$29100 hours10
Team$99500 hours50
EnterpriseCustomCustomUnlimited
Overages beyond included compute are billed at the standard rates.

​
Budget Guards

Set a maximum dollar amount per sandbox. When the budget is reached, the sandbox is automatically destroyed.

​
Via CLI

caged up --budget 5.00

​
Via Config

# .caged.yaml
budget: 5.00

​
Via API

curl -X POST https://api.caged.dev/v1/sandboxes \
  -H "Authorization: Bearer caged_sk_..." \
  -d '{"template": "node-20", "budget": 5.00}'

​
Budget Alerts

Automatic alerts fire at budget thresholds:
ThresholdAlert TypeAction
80%budget_warningNotification sent
95%budget_criticalUrgent notification
100%budget_exceededSandbox destroyed
Customize thresholds in Dashboard → Settings → Alert Rules.

​
Monitoring Spend

​
Real-Time

caged status cage-a1b2c3d4
# Shows current cost, budget remaining, burn rate

​
Dashboard

The dashboard shows:
  • Per-sandbox cost breakdown
  • Daily/weekly/monthly spend charts
  • Cost by agent type
  • Projected monthly spend

​
API

curl https://api.caged.dev/v1/billing/subscription \
  -H "Authorization: Bearer caged_sk_..."

​
Cost Optimization Tips

  1. Use idle timeouts — Auto-pause inactive sandboxes to stop compute charges
  2. Set budgets — Always set a budget guard to prevent runaway costs
  3. Right-size resources — Use 1 vCPU / 512MB for simple tasks
  4. Use snapshots — Pause and snapshot instead of keeping sandboxes running
  5. Clean up — Destroy sandboxes you’re done with