Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.copass.com/llms.txt

Use this file to discover all available pages before exploring further.

Copass uses credit-based billing. You top up a balance; agent runs, ingestion, and retrieval deduct from it as they go. No monthly subscription, no surprise overages — when the balance hits zero, calls fail closed until you top up again.

​
What you can do

  • Add a payment method (Stripe Checkout in your browser).
  • Top up your balance (any amount, one-shot or auto-pay).
  • Inspect current balance and recent ledger transactions.
  • Manage cards on file via the Stripe Customer Portal.

​
Via the CLI

# First time — guided setup (add card + first top-up)
copass billing setup

# Day-to-day inspection
copass billing status                # balance + default card + system status
copass billing balance               # USD balance only
copass billing transactions          # recent ledger (purchases, deductions, refunds)

# Top up (opens Stripe Checkout in browser)
copass billing top-up 50             # $50

# Card management
copass billing cards
copass billing add-card              # opens browser
copass billing portal                # Stripe Customer Portal — full self-serve

​
Via the Concierge

“What’s my balance?” “Show me recent transactions.”
The Concierge surfaces read-only billing info. Top-ups, card edits, and portal access all open Stripe Checkout in your browser — kept off the conversational surface so a chat turn can’t accidentally charge a card.

​
What deducts from your balance

ActivityDeduction
Agent runsPer-token, by model. The provider’s published rates plus a small platform fee.
Retrieval calls (discover / interpret / search)Per-call, with discover cheap and search heavier.
IngestionPer-document, weighted by extraction work (entity extraction is the dominant cost).
StorageFree up to your sandbox’s tier quota.
Run copass billing transactions to see the actual deduction lines for any time window.

​
Auto-pay

copass billing setup walks through enabling auto-pay — when balance falls below a threshold, your card on file is charged the configured amount automatically. Useful for production workloads; toggle it off via the Stripe Customer Portal at any time.

​
Common patterns

Dev: top up small, manually

A $10 top-up lasts most solo development for weeks. Watch copass billing transactions to learn your usage shape.

Production: auto-pay

Set a threshold and a top-up amount that covers ~1 week of expected usage. Calls fail closed if the card declines, so set the threshold above zero.

Cost-watch dashboard

Pipe copass billing transactions --json into your monitoring. Set alerts on per-day deduction spikes.

Self-serve everything

copass billing portal opens the Stripe Customer Portal — refunds, invoices, card swaps, tax IDs all live there.

​
Next steps

  • API keys — usage by these keys is what gets billed.
  • Security — how Copass handles your payment metadata.