Source: https://harnsy.dev/docs/usage

> See how much of each AI subscription your agents have left, when it runs out, and where the tokens went: by project, team, role and agent. harnsy Max.

# Usage

Your agents run on your own AI subscriptions. «Usage» shows how much each login has left in its 5-hour and weekly windows, when it will run out at today&#39;s pace, and which projects and agents spent it.

**Where.** «More» › «Usage» in the left rail (you can pin it). The «Node» button in the top bar also lists each login's limits, busiest first, with «All limits and history».

## Limits

For each subscription or login: the «5 hours» and «week» windows, as «N% used», with a forecast: «enough», «tight», «runs out at …» or «used up until …». A chart shows the use, an even pace and the forecast; another shows what each day took.

**Today's allowance** is what was left at the start of the day, split over the days to the reset. Near or over it, the line turns to a warning.

When one login is nearly out, «Switch a project's subscription» names up to three other logins of the same program. It is advice: nothing switches by itself from this page.

## Spend

Today, 7 days or 30 days, grouped by project, team, role, agent, login, program («Harness») or model. Each row shows tokens (input, cache write, cache read, output) and a cost in dollars. The cost is the program's own figure at API prices: it is not a bill, and a subscription is not charged by it. Codex reports no cost, so its sums are marked as partial.

## Actions and Team

- **Actions:** hours the agents' `harnsy run` commands took (tests, builds), per day. Their output is not stored.
- **Team** (every edition): where a team's tokens go, read from Claude Code sessions: turns, sizes and tool names.

## Where the numbers come from

harnsy reads them on this computer, from the AI programs' own files. It is built to make no requests to their vendors, and not to keep or use your account's login token: to tell logins apart, it takes only the e-mail address from the programs' login files (for Codex, decoded on this computer).

- **Claude Code:** limits come through Claude Code's status line, which must pass through harnsy. If they do not arrive, the page says «Claude's limits don't reach harnsy» and offers to set this up for you, or shows the line to put in front of your own status line. Tokens come from the session files.
- **Codex:** limits and tokens from Codex's own session logs; Codex reports no cost. «Spend credits after the limit» is off by default; you turn it on for each Codex login. While it is on, harnsy keeps starting agents on that login past its limit, on your account's paid credits; while it is off, harnsy stops or switches at the limit. It does not change Codex's own settings.
- **OpenCode:** spend from its own messages; it reports no limits.
- **pi:** only the spend it logs itself.

Use from claude.ai or another computer shows up at the next reading.

## At the limit

- **«Soft stop»** on the Limits tab (95% by default; 50–99, or 0 to switch it off): above this share of a subscription's 5-hour or weekly window, harnsy by itself neither wakes nor starts agents on it, and a scheduled run is skipped («skipped: out of tokens»). Running agents finish their turn; you and the team's lead still can start them.
- **A note to the lead** before that: Settings › «Lead reminders» › «Subscription limits — to the lead» (off by default; 85% by default). The soft stop itself is always told to the lead.
- **What an agent does at the limit:** in Teams › «Launch tree», «At the subscription's limit». «Wait for the reset» works in every edition. With several subscriptions (harnsy Max) it can also go to another one: «Another subscription and back» (the same session moves to another login and comes back when the first has room), «Move early, at the end of a turn», «Spare subscriptions», or an API key billed per use. Every login must be your own, and each is used under its vendor's terms: you answer for following them.

## Several logins

A connected subscription and a program's own login are listed apart. When two look like the same subscription, the page asks: «Merge» or «Not the same». You can rename a login.

## Privacy

- E-mail addresses are hidden on screen (shown as «Claude account 1»), so they do not show on screen recordings; one is revealed only when you ask, on this machine, and harnsy is built not to hand it to agents, other machines or the gateway.
- harnsy does not show Usage to agents; they can still read the AI programs' own files on this computer. From a phone or another computer it is read-only, with names hidden.
- Limit readings and daily totals per session are kept, with the agent, project, team and role; `harnsy run` history is kept 400 days, the detail of each run 30 days.

## Without harnsy Max

The page shows what harnsy Max adds; the «Team» tab works. harnsy does not keep limit or spend history without it.

[What it does →](https://harnsy.dev/features/usage)

[Questions? Ask on Discord →](https://discord.gg/nBrMhZPWzv)

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender and QR Code are names of their owners’ products. harnsy is not affiliated with or endorsed by them. iOS is a trademark of Cisco used under licence by Apple; QR Code is a registered trademark of DENSO WAVE INCORPORATED. No logos.
