> For the complete documentation index, see [llms.txt](https://docs.codewords.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codewords.ai/automations/usage.md).

# Usage

### What is the Usage page?

The [Usage page](https://codewords.agemo.ai/usage) is where you go to understand exactly how your credits are being consumed. It gives you a single, visual view of your spending across chats and workflow runs, your current wallet balance, your plan, and a detailed day-by-day breakdown of what each credit was used on. Open it from the sidebar, or directly at [codewords.agemo.ai/usage](https://codewords.agemo.ai/usage).

### What you can do there

**1. Cycle Spend**

* Shows the total credits used in the selected billing cycle (e.g. *141.85 credits over 5,818 requests*).
* A bar chart breaks each day’s spend into **Chat** (credits spent while building or chatting with Cody) and **Runs** (credits spent executing workflows).
* Use the date selector in the top-right to switch between billing cycles or pick a custom range.

**2. Wallet, Plan, and Top Category cards**

* **Wallet** — your current credit balance available to spend.
* **Plan** — the subscription tier you’re on (Free, Pro, Business) and any monthly credit allocation.
* **Top Category** — the area you’re spending the most on this cycle (e.g. *Chat — 137.20 credits · 97%*), so you can see at a glance whether your credits are going into building or running.

**3. Day Breakdown**

* Click any bar in the chart to open the breakdown for that specific day.
* The header shows the total credits spent and number of requests for the day (e.g. *29.94 credits · 497 requests*).
* Below, each chat or workflow run is listed individually with:
  * The chat or workflow name (e.g. Gmail AI Labeller , *LinkedIn Search: John Doe, Agemo*).
  * Whether it was a **Chat** or a **Run** and the number of calls/runs.
  * The credits it consumed.
* Click any row to expand it for the full call-by-call detail.

### When to use it

* **Reviewing your spend** — see where your credits went this cycle and which automations are most expensive.
* **Optimising workflows** — spot any chat or run that’s consuming an unexpectedly large share of your credits.
* **Planning top-ups or upgrades** — combine the cycle spend trend with your wallet balance to decide when to top up or move to a higher plan.
* **Investigating a specific day** — if your balance dropped suddenly, open that day in the breakdown to see exactly which chats or runs were responsible.

{% hint style="info" %}
For real-time run logs, statuses, and scheduled runs, use the [Activity page](/automations/activity.md). The Usage page focuses on **what credits were spent on**, while the Activity page focuses on **what ran and when**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.codewords.ai/automations/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.