Skip to main content

Configuring credit limits for your Agent

Ensure that your Agents don't incur runaway costs.

What are credits?

Credits are the unit of measurement Coworker uses to track AI usage across your workspace. Every time Coworker processes a task — whether you're chatting in Work mode or an Agent is running on a schedule — it consumes tokens to communicate with an underlying AI model. Credits abstract that cost into a simple number: 1 credit ≈ $0.50 in AI processing cost.

Your workspace has a monthly credit pool. Usage from all users and Agents draws from that pool. When the pool is exhausted, Agents pause and chats are blocked until the next billing cycle or until an admin purchases additional credits.

How do Agents consume credits?

Each time an Agent runs — whether triggered on-demand, by a schedule, or via a Slack mention — it consumes credits based on how much work it does. As a rough guide:

  • Simple tasks (e.g., a short summary or a single data lookup): \~2 credits per run

  • Complex tasks (e.g., multi-step research, drafting a document, coordinating across multiple tools): 5–10 credits per run

Credit consumption depends on the number of steps the Agent takes, the AI model used, and the length of inputs and outputs. You can view how many credits each of your Agents has consumed in the My Agents table, which shows a per-agent usage bar for the current billing period.

When an Agent run fails due to credit exhaustion, it will display a Credits Exhausted badge in the execution history.

Setting a monthly credit limit for an Agent

You can give any Agent a monthly credit budget to cap how many credits it can spend in a single billing period. This is useful when you want to experiment with a new Agent without risking it burning through your personal or team credit allocation.

By default, Agents have no credit limit — they can consume credits freely up to your personal or network-level cap.

To set a credit limit on an Agent:

  1. Go to the Agent Builder and open the Agent you want to configure (or create a new one).

  2. Underneath the Triggers section, expand the Credit Limit subsection.

  3. Enter a monthly credit budget in the input field. A tooltip next to the field shows your current billing period, your overall credit limit, and estimated per-run costs to help you choose a sensible value.

  4. Click Save. The limit takes effect immediately for the current billing period.

Note: Setting a limit below \~2 credits will trigger an inline warning, since that is lower than the cost of the cheapest viable Agent run.

Editing or removing a credit limit

  • To change a limit, return to the Credit Limit section in the Agent Builder, update the value, and save.

  • To remove a limit entirely, clear the credit limit field and save. The Agent will show No limit in the Agents table and can run freely within your personal or network-level caps.

Monitoring Agent credit usage

You can track credit consumption at any time from the My Agents tab. Each Agent row shows a usage bar representing credits used relative to its limit for the current billing period. Agents with no limit set display No limit alongside the raw credits-used count.

If you reach your personal credit cap, your Agents will pause and your Work chats will be blocked for the remainder of the billing period. Contact your workspace administrator to request a limit increase or additional credits.

Did this answer your question?