unlimited

How much of each AI subscription you have used, per window, and where each window is heading: Claude, Codex, Z.ai GLM, Kimi Code, OpenCode Go, Grok, Neuralwatt and Command Code, across every account on the machine.

It comes three ways, all from the same readings:

• In the menu bar: a macOS app, one tile per account.
• In the terminal: unlimited, a block per account.
• For agents: unlimited read --json, for load-balancing and pacing work across subscriptions.

uv tool install unlimited                # or: pipx install unlimited

unlimited                                # usage per account, for people
unlimited read [--vendor V]... [--max-age SECONDS] --json
unlimited capture claude-statusline      # in a Claude Code statusline script

Each reading gives each limit's window length, the fraction used so far, and its reset time. It also gives whether the vendor says the limit is held, and why, and, where the vendor names it, the account's plan and, for Claude, its credits: what it may spend once the windows are used. unlimited reports what the vendor says, and projects it forward: a reading never picks an account or draws a threshold. Choosing what to do with a reading is up to the consumer.

In the menu bar

Each tile shows an account's weekly use. When another of its windows is in worse shape, the tile cross-fades to it now and then. The thin bar beside each figure is how much of the week has passed. Where a vendor has several accounts, the one to use next is underlined.

The colour says where the window is heading, once there is enough to go on:

• Blue: it resets soon with room to spare. Spend it.
• Green: it is heading well under the limit.
• Plain: carry on.
• Amber: it might run out before it resets.
• Red: it will, or it has.

Click a tile for its account's windows. On each bar, the line is where an even pace would be by now, ▼ is where today's pace reaches by the reset and ▲ is the forecast. Below it: 🔥 when it runs out, 🎲 the chance it does, ↻ when it resets and 📈 the forecast. A forecast in a thinner weight rests on this window alone, before past windows back it. Click another tile to switch accounts. Settings relabels, hides and reorders tiles.

The app reads no credential and calls no vendor: it runs unlimited read --json. To build it, with Command Line Tools only:

cd macos && make app && open .build/Unlimited.app

In the terminal

For agents

unlimited read --json gives the same readings, one per account (one limit shown):

[
  {
    "schema": 1,
    "vendor": "anthropic",
    "account": "work",
    "taken_at": "2026-09-21T14:00:00+00:00",
    "source": "api",
    "plan": "default_claude_max_20x",
    "status": "ok",
    "why": null,
    "retry_until": null,
    "credits": {
      "taken_at": "2026-09-21T14:00:00+00:00",
      "enabled": true,
      "used": 12.5,
      "limit": 200.0,
      "balance": null,
      "currency": "SGD",
      "severity": "normal",
      "disabled_reason": null,
      "can_purchase": false
    },
    "names": ["work"],
    "limits": [
      {
        "name": "seven_day",
        "window_minutes": 10080,
        "used_at_least": 0.41,
        "resets_at": "2026-09-25T11:00:00+00:00",
        "held": false,
        "held_why": null,
        "severity": null,
        "active": null,
        "kind": null,
        "role": "weekly",
        "scope": null,
        "projection": {
          "at_reset": [0.873, 0.9436],
          "recent_at_reset": 0.9436,
          "exhausts_at": null,
          "run_out": 0.164,
          "samples": 2,
          "past_windows": 5,
          "since": "2026-09-20T14:00:00+00:00"
        }
      }
    ]
  }
]

Read projection.at_reset against used_at_least rather than either alone, and past_windows/samples for how much the projection rests on.

role says what kind of window a limit is, whatever the vendor calls it: session, weekly, weekly_model (one model's weekly limit, named in scope), month, extra (any other window, named in scope where the vendor names it), or null for an entry that repeats another or is not a window. names are this machine's names for the account: the config directories or wrappers holding its credential.

Models

unlimited models [--tier T] [--json] lists what each provider offers at a tier, promotions first; --provider P prints one model id; --catalog prints the whole merged catalog as JSON. The list ships in catalog.toml. ~/.config/unlimited/catalog.toml overrides it on one machine, with no release. Format and merge rules: docs/catalog.md.

unlimited off TARGET [--for 90m|12h|1d|1w] [--why TEXT] switches a provider (stealth), a model, a vendor, an offering id, or a provider:model pair off on this machine, until unlimited on TARGET or the --for time passes; unlimited off lists what is off. It drops out of models and --catalog like a ban. The switches live in ~/.config/unlimited/switches.json.

Outcomes

unlimited attempt start --provider P --model M --deadline S [--task LABEL] [--meta K=V]... records one use of a model and prints its id; unlimited attempt end ID --outcome ok|timeout|error|unavailable [--tokens-in N ...] [--meta K=V]... records how it came out. A start whose deadline passes with no end counts as a timeout. The task label and metadata are the caller's own: recorded with the request, never read by unlimited. unlimited outcomes prints each model's recent failure rate and durations on this machine, from ~/.local/state/unlimited/decisions.jsonl. unlimited choose --tier T --candidates P,... --deadline S [--quota P=ρ,...] [--temperature M] [--quota-weight M] [--task LABEL] [--meta K=V]... --json picks which candidate to use by expected minutes: failure rate and durations here, and the quota price of each candidate's projected use ρ (a live promotion's is free), weighed at --quota-weight minutes per unit. At --temperature 0 (the default) it takes the lowest; above it, it samples, a candidate that many minutes worse being e times less likely. It logs the whole request and the decision, with each candidate's odds, and prints the decision.

unlimited cards [--tier T] [--json] shows each route's model card: what its vendor publishes (intelligence, tokens per second, price per million tokens; the catalog's [[cards]]) beside what its runs here show (failure rate, durations, tokens, pace over the whole run, and the cost of a typical run at the card's price). Price and speed belong to the vendor, not the model: a route whose own vendor has no card shows another vendor's as a guideline only. Design: docs/choice.md.

Verdicts

unlimited verdict --work SECONDS [--model-scope M] [--max-age S] [--vendor V]... --json says, for each account, whether it can take a unit of work of that length on that model family: unread, excluded (with the window that binds and when it lifts), or ranked (with a tier and a score). Advisory: it reserves nothing. Design: docs/choice.md.

Credits

A window at 100% is not always the end. Where the vendor reports it (Claude's spend), the reading's credits says what the account may spend past its windows, in currency's major units: used of limit this period, any prepaid balance, and whether spending is enabled now, with the vendor's own disabled_reason when it is not (e.g. org_level_disabled_until, a cap the organisation switched off). limit: null with enabled: false is an account that never turned credits on. Whether more can be spent is enabled and used < limit; unlimited draws no line. credits.taken_at is when the vendor said so: a fresh statusline capture carries the last API read's credits forward, dated. credits is null for vendors without the concept, and is not projected: the vendor reports no reset for it.

Sources

The network endpoints are not officially documented and may change without notice. unlimited reads each tool's credential where the tool keeps it and never writes it back. The one token it refreshes is Grok's, whose sign-in lasts hours: the renewed token is kept, owner-only, in ~/.cache/unlimited/credentials/. No token appears in its output, readings or errors.

Projection

Each limit also carries a projection: where the window is heading, from the readings unlimited has taken. Within the window, two paces are extended to the reset — the average since it opened, and a recency-weighted pace with a half-life of a fourteenth of the window, which rises with a burst and falls in a quiet spell. Past windows of the same limit, kept for eight windows, add the shape of use (quiet nights, busy Mondays): each one's use from this point to its end, shifted to today's. They take over from the paces between the third and eighth window.

at_reset is [low, high], unclamped, so 1.07 means use would pass the limit. recent_at_reset is the recent pace alone extended to the reset: today's momentum, which past windows do not move. exhausts_at is when the high end reaches it, if before the reset. run_out is how likely use passes it, from the past windows that did, or null without them. samples, past_windows and since say what it rests on. A projection is only as good as how often something reads: a statusline capture feeds it continuously.

Cache

There is one cache file and one flock per vendor under $XDG_CACHE_HOME/unlimited, mode 0600. Concurrent callers share one upstream request. A 429's Retry-After holds off every caller until it passes, capped at 24 hours; a 429 or 5xx holds off at least five minutes, and the account's last good reading stands in the meantime. On macOS the keychain is readable only from the user's GUI session or launchd, not over plain ssh.

Status

Pre-release. The schema ("schema": 1) may still change.

Releasing

main takes changes only through a pull request that passes the tests and the identity check. Bump version in pyproject.toml in one, merge it, then tag the merge commit vX.Y.Z and push the tag: the Publish workflow puts it on PyPI by trusted publishing, with no stored token.

2mw2lt

unlimited was built alongside 2mw2lt — Too Much Work, Too Little Time — a steering partner that coordinates work across AI workers and trusted people, which reads its accounts through unlimited. unlimited knows nothing of 2mw2lt and is meant to be useful on its own. Its sibling work-tempo tracks source-code momentum across Git workspaces.