Skip to main content
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 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. Messages you may see:
  • “Agent has spent AofitsA of its B monthly budget. Raise it in Edit agent → Budget.”
  • “Agent has spent AofitsA of its B daily budget. It resets at 00:00 UTC.”
  • “Your account has spent AofitsA of its B monthly budget. Raise it with a code in Settings → Usage → Have a code?”
  • “Your account has spent AofitsA 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. 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.