# Runs and billing - Obss

Set up
Runs and billing
How Obss counts runs, what the free plan covers, and how to check your balance, subscribe, or top up.
Obss bills in runs, from one run balance that every member of your organization shares. Checking it is step 6 of the
setup checklist
. For plans and prices, see
Pricing
.
What counts as a run
A run is one agent’s attempt at one task with one treatment. An experiment launches a run for every combination of its inputs:
runs = tasks × treatments × agents × trials
For example, 2 tasks × 2 treatments × 1 agent × 3 trials is 12 runs, because each trial repeats the same inputs (
Experiments
).
Run
Counts?
A completed run, whether it passes or fails its rubric
Yes
A
Test agent
run for a custom agent
Yes
An errored or cancelled run
No
What runs pay for
Runs pay for running your experiments on Obss, including the cloud machines. Model use isn’t included. Agents and Obss AI features use your own keys or subscriptions, and your
model providers
bill that use directly. Obss can limit use to keep capacity fair for all organizations.
Free plan, subscriptions, and top-ups
Every organization starts on the
free plan
, which resets its runs each month and needs no credit card.
Kind of run
How it works
Plan runs
Your plan grants them each billing period. Unused plan runs don’t roll over, and they expire when the plan ends.
Top-up runs
You buy them at any time. They never expire, and larger top-ups cost less per run.
Every plan includes every feature, the dashboard, the CLI, and the plugin, with unlimited free members and unlimited projects, experiments, tasks, treatments, and tools.
Check your run balance
Dashboard
CLI
Plugin (MCP)
Open
Organization settings → Usage & billing
.
New experiment
also shows how many runs a launch uses.
obss
quota
inspect
To check that a launch of a given size fits, pass
--requested-runs
. To page through the history, use
obss quota ledger
(
obss quota inspect
).
Ask your AI assistant how many runs you have. It calls
Get the run balance
(
inspect_quota
), or
List run balance history
(
list_quota_ledger
) for the history.
Usage & billing
has four sections:
Section
What it shows
Runs
The balance, split into plan and top-up runs, and when plan runs reset
Your plan
The current plan and its state,
Manage billing
, and
Other plans
with
Upgrade
or
Downgrade
Top up
Run packs to buy
History
Plan allowances, purchases, and other changes to the balance
Get more runs
You buy runs and change plans only in the dashboard, because Stripe handles checkout.
obss quota inspect
returns the
Usage & billing
link (
billingUrl
), but the plugin’s quota tools return no billing link.
Open
Organization settings → Usage & billing
, or start from
Pricing
.
Choose a plan under
Your plan
for more monthly runs at a lower price per run, or an amount under
Top up
for runs that never expire.
Complete checkout in Stripe.
To change payment details or see invoices, select
Manage billing
. For volume pricing, email
support@obss.app
.
When you don’t have enough runs
Obss blocks a launch that needs more runs than you have. Top up, or use fewer tasks, agents, treatments, or trials, then launch again. A
schedule
that’s short of runs sends a notice, and Obss pauses it if runs are still short when a launch is due.
From the CLI and the plugin
Task
CLI
Plugin (MCP)
Read the run balance and launch readiness
obss quota inspect
inspect_quota
Page the balance history
obss quota ledger
list_quota_ledger
Buy runs or change plan
Dashboard only.
obss quota inspect
prints the
Usage & billing
link.
Dashboard only. The plugin returns no billing link.
Next steps
Profile and API keys
Step 7: connect your subscriptions and create API keys.
Launch an experiment
See how tasks, agents, and trials add up to the run total.
Notifications
Step 8: get a notice when your run balance changes.
FAQ
Read answers to common billing questions.
Obss AI features
Profile
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform