Wallet and usage
Your account wallet — available budget, reservations and spend — how session budgets draw on it, how to add credit or set a budget, and where to see what every session cost.
On this page
The wallet is your account's spending limit for Ysra's work. It belongs to your organisation if you're part of one, and to you otherwise.
A limit, not a payment method
Adding credit or setting a budget changes the limit; it doesn't charge a card. Nothing on this page is a purchase.
Reading the wallet#
| Figure | Meaning |
|---|---|
| Available | What new work can still spend: budget minus reserved minus spent. |
| Budget | The total you've allowed. |
| Reserved | Held by sessions that are running right now. |
| Spent | Settled cost of finished work. |
The wallet on the phone.
How sessions use it#
- When a session starts, it reserves its budget from the wallet.
- As it works, cost is recorded against that reservation.
- When it ends, actual cost is settled and anything unused is returned.
- If a session would exceed its budget, it stops and asks — see Start a session.
Add credit or set a budget#
Workspace → Wallet & usage:
- Add credit increases the budget by an amount.
- Set budget replaces the total. It can't go below what's already spent or reserved.
Both are safe to retry: a request sent twice moves the money once. If someone else changed the wallet at the same moment, you're shown the current figures instead of silently overwriting them.
Usage#
The usage view breaks spending down by session, repository and project:
- Usage events — each unit of work with its session, repository, calls, tokens and cost.
- Wallet ledger — every movement: budget set, credit added, reserved, released, spent.
- Lifetime totals — cost, calls, tokens and events.
Every session also shows its own spend against its budget in the workroom header, and in its report.
When the wallet is enforced#
A new account starts with each session's budget as the only limit. The wallet becomes enforced as soon as you set a budget or add credit; from then on, sessions can only reserve what the wallet has available.