> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worksong.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage and spend

> See what your Agents cost, and set the limits that keep spending in check.

Usage shows what all your Agents spent this month, where it went, and how close you are to your limit.

Open it from **Profile > Usage** on the phone, or from **Settings** on the desktop.

## What the screen shows

* **This month.** The month's spend, a line such as "\$6.64 left this month", and a bar. The badge says **within cap**, **nearly spent** or **cap reached**.
* **AI and Computer.** When your Agents used a Computer or sandbox, the spend is split in two: `AI $...` and `Computer & sandbox $... (hours)`.
* **Agent activity.** A link to [Insights](https://docs.worksong.ai/worksong/activity-and-insights.md) for tokens, actions and runs over time.
* **Have a code?** Enter a code and tap **Apply** to raise your monthly spending limit. Nothing is charged and no features change. After it works, the message says by how much and what the new limit is. Codes use letters, digits, hyphens and underscores.
* **Where it went.** One row per Agent with its runs, tokens and cost. A cost below one cent is shown with more decimals, never as zero.
* **Recent runs.** Each run with its Agent, status (queued, running, done, failed, stopped), duration and cost. A running run has a **Stop** button. Stopping a run stops its spending, and a reply still being written is lost. If the run already finished, nothing is stopped and the app tells you.

## The limits

Several limits work together. Each turn runs under the **smallest** of them, and a turn that has no room left is refused before it starts, with a message that names the limit.

| Limit | Where you set it | Resets |
| - | - | - |
| Per run, per Agent | **Edit agent > Budget > Per run, USD** | Each run |
| Monthly, per Agent | **Edit agent > Budget > Per month, USD** (empty = no cap) | Calendar month |
| Daily, per Agent | **Edit agent > Budget > Per day, USD** (empty = no cap) | 00:00 UTC |
| Monthly, whole account | Raised with a code in **Usage > Have a code?** | Calendar month |
| Daily, whole account | **Settings > Daily spending limit** | 00:00 UTC |
| Computer and sandbox hours, per Agent | **Edit agent > Computer & sandbox hours per day** (see [Agents](https://docs.worksong.ai/worksong/agents.md)) | 00:00 UTC |
| Phone calls | **Connections > Phone calls** (see [Phone and voice calls](https://docs.worksong.ai/worksong/phone-and-voice-calls.md)) | Per call, day, month |

Messages you may see:

* "*Agent* has spent $A of its $B monthly budget. Raise it in Edit agent → Budget."
* "*Agent* has spent $A of its $B daily budget. It resets at 00:00 UTC."
* "Your account has spent $A of its $B monthly budget. Raise it with a code in Settings → Usage → Have a code?"
* "Your account has spent $A of its $B daily budget. It resets at 00:00 UTC."
* "*Agent* has used its 8 h daily limit of Computer & sandbox time. It resets at 00:00 UTC." (the number of hours is the Agent's own limit)

Spend can pass a limit by the end of the reply that was already running. That is why a line can read "over by \$0.01".

## Daily spending limit

**Daily spending limit** is the most all your Agents together may spend in one UTC day. It is empty by default (no limit). Enter an amount in dollars and tap **Save**, or tap **Remove limit**. An amount of 0 stops all spending.

What counts as spend is the same as for the monthly limit: AI cost plus Computer and sandbox time. When today's spend reaches the limit, new turns and new Computer sessions wait until 00:00 UTC, or until you raise it. The tighter of the daily and monthly limits applies.

<sub>Source: `worksong-ai/worksong:apps/mobile/src/features/usage/UsageScreen.tsx@9f0684f`, `worksong-ai/worksong:apps/mobile/src/features/usage/usageSummary.ts@9f0684f`, `worksong-ai/worksong:packages/shared/src/runBudget.ts@9f0684f`, `worksong-ai/worksong:apps/mobile/src/features/settings/DailyLimitCard.tsx@9f0684f`, `worksong-ai/worksong:docs/API.md@9f0684f`. Docs version: Worksong 2.0 with Work 1.2.</sub>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.