unlimited 0.0.9__tar.gz

unlimited-0.0.9/.githooks/check-identity.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# Every commit here is the owner's or a bot's, under a GitHub noreply address. Signing in as
+# another of the owner's accounts is the mistake this catches: its address is noreply too.
+#
+#   check-identity.sh <range>   every commit in the range, and its Co-authored-by trailers
+#   check-identity.sh           the identity the next commit would take
+#
+# GitHub's own committer is allowed for merges it performs; an AI model (Claude, Codex) may
+# be credited as co-author.
+set -eu
+
+OWNER='5214595\+ren-diao@users\.noreply\.github\.com'
+BOT='[0-9]+\+[a-z0-9-]+\[bot\]@users\.noreply\.github\.com'
+ALLOWED_AUTHOR="^($OWNER|$BOT)$"
+ALLOWED_COMMITTER="^($OWNER|$BOT|noreply@github\.com)$"
+ALLOWED_COAUTHOR="^($OWNER|$BOT|[^@]+@anthropic\.com|[^@]+@openai\.com)$"
+
+fail=0
+report() {  # role, email, where
+  printf '  %s email %s is not permitted (%s)\n' "$1" "$2" "$3" >&2
+  fail=1
+}
+
+if [ $# -eq 0 ]; then
+  a=$(git var GIT_AUTHOR_IDENT | sed -n 's/.*<\(.*\)>.*/\1/p')
+  c=$(git var GIT_COMMITTER_IDENT | sed -n 's/.*<\(.*\)>.*/\1/p')
+  printf '%s\n' "$a" | grep -Eq "$ALLOWED_AUTHOR" || report author "$a" "this commit"
+  printf '%s\n' "$c" | grep -Eq "$ALLOWED_COMMITTER" || report committer "$c" "this commit"
+else
+  commits=$(git log --format='%h %ae %ce' "$1")   # a bad range must exit, not read nothing
+  while read -r sha a c; do
+    [ -z "$sha" ] && continue
+    printf '%s\n' "$a" | grep -Eq "$ALLOWED_AUTHOR" || report author "$a" "$sha"
+    printf '%s\n' "$c" | grep -Eq "$ALLOWED_COMMITTER" || report committer "$c" "$sha"
+    for co in $(git log -1 --format='%(trailers:key=Co-authored-by,valueonly)' "$sha" | sed -n 's/.*<\(.*\)>.*/\1/p'); do
+      printf '%s\n' "$co" | grep -Eq "$ALLOWED_COAUTHOR" || report co-author "$co" "$sha"
+    done
+  done <<EOF
+$commits
+EOF
+fi
+
+if [ "$fail" -ne 0 ]; then
+  cat >&2 <<'WHY'
+
+Set this repository's own identity and commit again:
+  git config user.email '5214595+ren-diao@users.noreply.github.com'
+  git commit --amend --reset-author   # if the commit is already made
+WHY
+  exit 1
+fi

unlimited-0.0.9/.githooks/check-identity.test.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# check-identity.sh against commits made in a scratch repository.
+set -eu
+HERE=$(cd "$(dirname "$0")" && pwd)
+T=$(mktemp -d); trap 'rm -rf "$T"' EXIT
+cd "$T" && git init -q && git config user.useConfigOnly true && git config user.name t
+fail=0
+commit() {  # email, message
+  GIT_COMMITTER_EMAIL="$1" git -c user.email="$1" commit -q --allow-empty -m "$2"
+}
+expect() {  # pass|fail, what
+  if bash "$HERE/check-identity.sh" HEAD~1..HEAD >/dev/null 2>&1; then got=pass; else got=fail; fi
+  [ "$got" = "$1" ] && echo "  ok - $2" || { echo "  FAIL - $2 (got $got)"; fail=1; }
+}
+commit 5214595+ren-diao@users.noreply.github.com root
+commit 5214595+ren-diao@users.noreply.github.com "$(printf 'x\n\nCo-authored-by: Claude Opus 5 <noreply@anthropic.com>')"
+expect pass "the owner, with Claude as co-author"
+commit 5214595+ren-diao@users.noreply.github.com "$(printf 'v\n\nCo-authored-by: Codex <codex@openai.com>')"
+expect pass "the owner, with Codex as co-author"
+commit 326013263+endario-ci[bot]@users.noreply.github.com y
+expect pass "a bot"
+commit 999+another-account@users.noreply.github.com z
+expect fail "another of the owner's accounts, though its address is noreply"
+commit 5214595+ren-diao@users.noreply.github.com "$(printf 'w\n\nCo-authored-by: q <999+another-account@users.noreply.github.com>')"
+expect fail "another account credited as co-author"
+exit $fail

unlimited-0.0.9/.github/workflows/identity.yml

@@ -0,0 +1,31 @@
+name: Identity
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  identity:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: The check refuses what it should
+        run: bash .githooks/check-identity.test.sh
+      - name: Every new commit is the owner's or a bot's
+        env:
+          BASE: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}
+          HEAD_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+        run: |
+          if [ -z "$BASE" ] || [ "$BASE" = "0000000000000000000000000000000000000000" ] \
+             || ! git cat-file -e "$BASE" 2>/dev/null; then
+            range="$HEAD_SHA~1..$HEAD_SHA"
+          else
+            range="$BASE..$HEAD_SHA"
+          fi
+          bash .githooks/check-identity.sh "$range"

unlimited-0.0.9/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # PyPI trusted publishing: no token is stored anywhere
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

unlimited-0.0.9/.github/workflows/test.yml

@@ -0,0 +1,14 @@
+name: test
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: PYTHONPATH=src python -m unittest discover -s tests -v

unlimited-0.0.9/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+*.egg-info/

unlimited-0.0.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ren Diao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

unlimited-0.0.9/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.5
+Name: unlimited
+Version: 0.0.9
+Summary: Read AI-subscription quota usage, per window, as facts — and where each window is heading.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# unlimited
+
+Read AI-subscription quota usage, per window, as facts — and where each window is heading.
+
+```
+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. unlimited reports what the vendor says, and projects it forward: it never
+picks an account or draws a threshold. Choosing what to do with a reading is up to the consumer.
+
+## For people
+
+![unlimited status: one block per account, a bar per usage window, and a forecast line under each](docs/status.svg)
+
+## For agents
+
+`unlimited read --json` gives the same readings, one per account, for load-balancing and pacing
+work across subscriptions (one limit shown):
+
+```json
+[
+  {
+    "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,
+    "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,
+        "projection": {
+          "at_reset": [0.873, 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.
+
+## Sources
+
+| Vendor | Local, no network | Network |
+|---|---|---|
+| Anthropic (Claude Code, claude.ai sign-in) | the `rate_limits` Claude Code hands its statusline, via `capture` | `oauth/usage` on Claude Code's own token |
+| OpenAI (Codex, ChatGPT sign-in) | `rate_limits` in Codex's session logs | `wham/usage` on Codex's own token |
+| Z.ai (GLM coding plan) | — | `quota/limit` on the plan's API key |
+| OpenCode Go | — | `zen/go/v1/usage` on the Go API key opencode keeps |
+| xAI Grok (SuperGrok, Grok CLI sign-in) | — | the Grok CLI's billing proxy on its own token |
+
+The network endpoints are not officially documented and may change without notice. unlimited
+reads each harness's credential where the harness keeps it. It never refreshes a token or
+writes a credential, and no token appears in its output, cache 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. `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.
+
+## 2mw2lt
+
+unlimited is part of [2mw2lt](https://2mw2lt.com) — *Too Much Work, Too Little Time* — a steering
+partner that coordinates work across AI workers and trusted people. 2mw2lt reads its accounts
+through unlimited.

unlimited-0.0.9/README.md

@@ -0,0 +1,113 @@
+# unlimited
+
+Read AI-subscription quota usage, per window, as facts — and where each window is heading.
+
+```
+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. unlimited reports what the vendor says, and projects it forward: it never
+picks an account or draws a threshold. Choosing what to do with a reading is up to the consumer.
+
+## For people
+
+![unlimited status: one block per account, a bar per usage window, and a forecast line under each](docs/status.svg)
+
+## For agents
+
+`unlimited read --json` gives the same readings, one per account, for load-balancing and pacing
+work across subscriptions (one limit shown):
+
+```json
+[
+  {
+    "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,
+    "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,
+        "projection": {
+          "at_reset": [0.873, 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.
+
+## Sources
+
+| Vendor | Local, no network | Network |
+|---|---|---|
+| Anthropic (Claude Code, claude.ai sign-in) | the `rate_limits` Claude Code hands its statusline, via `capture` | `oauth/usage` on Claude Code's own token |
+| OpenAI (Codex, ChatGPT sign-in) | `rate_limits` in Codex's session logs | `wham/usage` on Codex's own token |
+| Z.ai (GLM coding plan) | — | `quota/limit` on the plan's API key |
+| OpenCode Go | — | `zen/go/v1/usage` on the Go API key opencode keeps |
+| xAI Grok (SuperGrok, Grok CLI sign-in) | — | the Grok CLI's billing proxy on its own token |
+
+The network endpoints are not officially documented and may change without notice. unlimited
+reads each harness's credential where the harness keeps it. It never refreshes a token or
+writes a credential, and no token appears in its output, cache 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. `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.
+
+## 2mw2lt
+
+unlimited is part of [2mw2lt](https://2mw2lt.com) — *Too Much Work, Too Little Time* — a steering
+partner that coordinates work across AI workers and trusted people. 2mw2lt reads its accounts
+through unlimited.

unlimited-0.0.9/docs/preview.py

@@ -0,0 +1,57 @@
+"""Regenerates the README's previews from fixed readings:
+    TZ=UTC uv run --with rich python docs/preview.py
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+from datetime import datetime, timedelta, timezone
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
+from rich.console import Console  # noqa: E402
+from rich.text import Text  # noqa: E402
+
+from unlimited import projection, show  # noqa: E402
+from unlimited.schema import limit, reading  # noqa: E402
+
+NOW = datetime(2026, 9, 21, 14, 0, tzinfo=timezone.utc)
+H, D = timedelta(hours=1), timedelta(days=1)
+
+
+def win(account, name, minutes, resets, pairs, past=()):
+    """History for one window: (time before NOW, used) pairs, plus past windows' curves."""
+    samples = [[(NOW - ago).isoformat(), u, resets.isoformat()] for ago, u in pairs]
+    return {f"{account}\t{name}": {"samples": samples, "window_minutes": minutes, "past": [
+        {"resets_at": (resets - timedelta(minutes=minutes) * (len(past) - i)).isoformat(),
+         "curve": [round(f(x / projection.GRID), 4) for x in range(projection.GRID + 1)]}
+        for i, f in enumerate(past)]}}
+
+
+claude_week, codex_week = NOW + 3 * D + 21 * H, NOW + 2 * D + 5 * H
+history = {
+    **win("work", "five_hour", 300, NOW + 2 * H, [(2 * H, 0.08), (H, 0.2), (0 * H, 0.31)]),
+    **win("work", "seven_day", 10080, claude_week, [(D, 0.33), (0 * H, 0.41)],
+          past=[lambda x: min(0.95 * x ** 1.1, 1)] * 5),
+    **win("codex", "codex", 10080, codex_week, [(D, 0.45), (6 * H, 0.62), (0 * H, 0.7)]),
+}
+readings = [
+    reading("anthropic", "work", NOW, "ok", plan="default_claude_max_20x", limits=[
+        limit("five_hour", window_minutes=300, used_at_least=0.31, resets_at=NOW + 2 * H, held=False),
+        limit("seven_day", window_minutes=10080, used_at_least=0.41, resets_at=claude_week, held=False)]),
+    reading("openai", "codex", NOW - 7 * 60 * timedelta(seconds=1), "ok", plan="pro", source="session-log", limits=[
+        limit("codex", window_minutes=10080, used_at_least=0.7, resets_at=codex_week, held=False)]),
+    dict(reading("zai", "glm", NOW - 12 * 60 * timedelta(seconds=1), "ok", plan="max", limits=[
+        limit("five_hour", window_minutes=300, used_at_least=0.92, resets_at=NOW + 40 * 60 * timedelta(seconds=1),
+              held=True, held_why="limit_reached")]),
+         retry_until=(NOW + 3 * 60 * timedelta(seconds=1)).isoformat()),
+]
+readings = [projection.attach(r, history) for r in readings]
+show._claude_dirs = lambda: {"work": "work"}
+
+out = Path(__file__).parent
+console = Console(record=True, width=104, file=open("/dev/null", "w"))
+console.print(Text.from_ansi("$ unlimited\n" + show.render(readings, NOW, color=True).rstrip()))
+(out / "status.svg").write_text(console.export_svg(title="unlimited"))
+print(json.dumps([dict(readings[0], limits=readings[0]["limits"][1:])], indent=2))  # the README's JSON

unlimited-0.0.9/docs/status.svg

@@ -0,0 +1,108 @@
+<svg class="rich-terminal" viewBox="0 0 1287 367.2" xmlns="http://www.w3.org/2000/svg">
+    <!-- Generated with Rich https://www.textualize.io -->
+    <style>
+
+    @font-face {
+        font-family: "Fira Code";
+        src: local("FiraCode-Regular"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff");
+        font-style: normal;
+        font-weight: 400;
+    }
+    @font-face {
+        font-family: "Fira Code";
+        src: local("FiraCode-Bold"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Bold.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Bold.woff") format("woff");
+        font-style: bold;
+        font-weight: 700;
+    }
+
+    .terminal-415471781-matrix {
+        font-family: Fira Code, monospace;
+        font-size: 20px;
+        line-height: 24.4px;
+        font-variant-east-asian: full-width;
+    }
+
+    .terminal-415471781-title {
+        font-size: 18px;
+        font-weight: bold;
+        font-family: arial;
+    }
+
+    .terminal-415471781-r1 { fill: #c5c8c6 }
+.terminal-415471781-r2 { fill: #98a84b }
+.terminal-415471781-r3 { fill: #cc555a }
+    </style>
+
+    <defs>
+    <clipPath id="terminal-415471781-clip-terminal">
+      <rect x="0" y="0" width="1267.8" height="316.2" />
+    </clipPath>
+    <clipPath id="terminal-415471781-line-0">
+    <rect x="0" y="1.5" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-1">
+    <rect x="0" y="25.9" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-2">
+    <rect x="0" y="50.3" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-3">
+    <rect x="0" y="74.7" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-4">
+    <rect x="0" y="99.1" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-5">
+    <rect x="0" y="123.5" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-6">
+    <rect x="0" y="147.9" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-7">
+    <rect x="0" y="172.3" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-8">
+    <rect x="0" y="196.7" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-9">
+    <rect x="0" y="221.1" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-10">
+    <rect x="0" y="245.5" width="1268.8" height="24.65"/>
+            </clipPath>
+<clipPath id="terminal-415471781-line-11">
+    <rect x="0" y="269.9" width="1268.8" height="24.65"/>
+            </clipPath>
+    </defs>
+
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1285" height="365.2" rx="8"/><text class="terminal-415471781-title" fill="#c5c8c6" text-anchor="middle" x="642" y="27">unlimited</text>
+            <g transform="translate(26,22)">
+            <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
+            <circle cx="22" cy="0" r="7" fill="#febc2e"/>
+            <circle cx="44" cy="0" r="7" fill="#28c840"/>
+            </g>
+        
+    <g transform="translate(9, 41)" clip-path="url(#terminal-415471781-clip-terminal)">
+    
+    <g class="terminal-415471781-matrix">
+    <text class="terminal-415471781-r1" x="0" y="20" textLength="134.2" clip-path="url(#terminal-415471781-line-0)">$&#160;unlimited</text><text class="terminal-415471781-r1" x="1268.8" y="20" textLength="12.2" clip-path="url(#terminal-415471781-line-0)">
+</text><text class="terminal-415471781-r1" x="0" y="44.4" textLength="256.2" clip-path="url(#terminal-415471781-line-1)">Claude&#160;Max&#160;20x&#160;·&#160;work</text><text class="terminal-415471781-r1" x="1268.8" y="44.4" textLength="12.2" clip-path="url(#terminal-415471781-line-1)">
+</text><text class="terminal-415471781-r1" x="0" y="68.8" textLength="219.6" clip-path="url(#terminal-415471781-line-2)">&#160;&#160;5-hour&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-415471781-r2" x="219.6" y="68.8" textLength="329.4" clip-path="url(#terminal-415471781-line-2)">██████░░░░░░░░░░░░░░&#160;&#160;31.0%</text><text class="terminal-415471781-r1" x="549" y="68.8" textLength="390.4" clip-path="url(#terminal-415471781-line-2)">&#160;&#160;resets&#160;in&#160;&#160;2h&#160;00m&#160;&#160;(Mon&#160;16:00)</text><text class="terminal-415471781-r1" x="1268.8" y="68.8" textLength="12.2" clip-path="url(#terminal-415471781-line-2)">
+</text><text class="terminal-415471781-r1" x="0" y="93.2" textLength="244" clip-path="url(#terminal-415471781-line-3)">&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;→&#160;</text><text class="terminal-415471781-r2" x="244" y="93.2" textLength="73.2" clip-path="url(#terminal-415471781-line-3)">52–53%</text><text class="terminal-415471781-r1" x="317.2" y="93.2" textLength="109.8" clip-path="url(#terminal-415471781-line-3)">&#160;at&#160;reset</text><text class="terminal-415471781-r1" x="1268.8" y="93.2" textLength="12.2" clip-path="url(#terminal-415471781-line-3)">
+</text><text class="terminal-415471781-r1" x="0" y="117.6" textLength="219.6" clip-path="url(#terminal-415471781-line-4)">&#160;&#160;weekly&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-415471781-r2" x="219.6" y="117.6" textLength="329.4" clip-path="url(#terminal-415471781-line-4)">████████░░░░░░░░░░░░&#160;&#160;41.0%</text><text class="terminal-415471781-r1" x="549" y="117.6" textLength="390.4" clip-path="url(#terminal-415471781-line-4)">&#160;&#160;resets&#160;in&#160;&#160;3d&#160;21h&#160;&#160;(Fri&#160;11:00)</text><text class="terminal-415471781-r1" x="1268.8" y="117.6" textLength="12.2" clip-path="url(#terminal-415471781-line-4)">
+</text><text class="terminal-415471781-r1" x="0" y="142" textLength="244" clip-path="url(#terminal-415471781-line-5)">&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;→&#160;</text><text class="terminal-415471781-r3" x="244" y="142" textLength="73.2" clip-path="url(#terminal-415471781-line-5)">87–94%</text><text class="terminal-415471781-r1" x="317.2" y="142" textLength="719.8" clip-path="url(#terminal-415471781-line-5)">&#160;at&#160;reset&#160;·&#160;16%&#160;chance&#160;of&#160;running&#160;out&#160;·&#160;from&#160;5&#160;past&#160;windows</text><text class="terminal-415471781-r1" x="1268.8" y="142" textLength="12.2" clip-path="url(#terminal-415471781-line-5)">
+</text><text class="terminal-415471781-r1" x="1268.8" y="166.4" textLength="12.2" clip-path="url(#terminal-415471781-line-6)">
+</text><text class="terminal-415471781-r1" x="0" y="190.8" textLength="549" clip-path="url(#terminal-415471781-line-7)">Codex&#160;Pro&#160;·&#160;codex&#160;&#160;(read&#160;7m&#160;ago,&#160;session-log)</text><text class="terminal-415471781-r1" x="1268.8" y="190.8" textLength="12.2" clip-path="url(#terminal-415471781-line-7)">
+</text><text class="terminal-415471781-r1" x="0" y="215.2" textLength="219.6" clip-path="url(#terminal-415471781-line-8)">&#160;&#160;weekly&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-415471781-r2" x="219.6" y="215.2" textLength="329.4" clip-path="url(#terminal-415471781-line-8)">██████████████░░░░░░&#160;&#160;70.0%</text><text class="terminal-415471781-r1" x="549" y="215.2" textLength="390.4" clip-path="url(#terminal-415471781-line-8)">&#160;&#160;resets&#160;in&#160;&#160;&#160;2d&#160;5h&#160;&#160;(Wed&#160;19:00)</text><text class="terminal-415471781-r1" x="1268.8" y="215.2" textLength="12.2" clip-path="url(#terminal-415471781-line-8)">
+</text><text class="terminal-415471781-r1" x="0" y="239.6" textLength="244" clip-path="url(#terminal-415471781-line-9)">&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;→&#160;</text><text class="terminal-415471781-r3" x="244" y="239.6" textLength="97.6" clip-path="url(#terminal-415471781-line-9)">102–125%</text><text class="terminal-415471781-r1" x="341.6" y="239.6" textLength="500.2" clip-path="url(#terminal-415471781-line-9)">&#160;at&#160;reset&#160;·&#160;runs&#160;out&#160;Tue&#160;19:07&#160;(in&#160;1d&#160;5h)</text><text class="terminal-415471781-r1" x="1268.8" y="239.6" textLength="12.2" clip-path="url(#terminal-415471781-line-9)">
+</text><text class="terminal-415471781-r1" x="1268.8" y="264" textLength="12.2" clip-path="url(#terminal-415471781-line-10)">
+</text><text class="terminal-415471781-r1" x="0" y="288.4" textLength="756.4" clip-path="url(#terminal-415471781-line-11)">Z.ai&#160;GLM&#160;Max&#160;·&#160;glm&#160;&#160;(read&#160;12m&#160;ago,&#160;throttled:&#160;next&#160;read&#160;in&#160;3m)</text><text class="terminal-415471781-r1" x="1268.8" y="288.4" textLength="12.2" clip-path="url(#terminal-415471781-line-11)">
+</text><text class="terminal-415471781-r1" x="0" y="312.8" textLength="219.6" clip-path="url(#terminal-415471781-line-12)">&#160;&#160;5-hour&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-415471781-r3" x="219.6" y="312.8" textLength="329.4" clip-path="url(#terminal-415471781-line-12)">██████████████████░░&#160;&#160;92.0%</text><text class="terminal-415471781-r1" x="549" y="312.8" textLength="646.6" clip-path="url(#terminal-415471781-line-12)">&#160;&#160;resets&#160;in&#160;&#160;&#160;&#160;&#160;40m&#160;&#160;(Mon&#160;14:40)&#160;&#160;HELD:&#160;limit_reached</text><text class="terminal-415471781-r1" x="1268.8" y="312.8" textLength="12.2" clip-path="url(#terminal-415471781-line-12)">
+</text>
+    </g>
+    </g>
+</svg>

unlimited-0.0.9/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "unlimited"
+version = "0.0.9"
+description = "Read AI-subscription quota usage, per window, as facts — and where each window is heading."
+requires-python = ">=3.11"
+license = "MIT"
+readme = "README.md"
+dependencies = []
+
+[project.scripts]
+unlimited = "unlimited.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

unlimited-0.0.9/src/unlimited/__init__.py

@@ -0,0 +1,24 @@
+"""Read AI-subscription quota usage, per window, as facts."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from . import cache, transport
+from .adapters import REGISTRY
+
+VENDORS = tuple(sorted(REGISTRY))
+
+
+def read(vendors: list[str] | None = None, *, max_age: float = 300.0) -> list[dict]:
+    """Readings for each vendor's accounts on this machine, through the shared cache."""
+    out = []
+    for v in vendors or VENDORS:
+        out += cache.through(REGISTRY[v], max_age=max_age,
+                             clock=lambda: datetime.now(timezone.utc), get=transport.get)
+    return out
+
+
+def accounts(vendor: str) -> list[str]:
+    """The account ids this machine can read for one vendor, without asking the vendor."""
+    return [c.account for c in REGISTRY[vendor].discover() if c.account]

unlimited-0.0.9/src/unlimited/adapters/__init__.py

@@ -0,0 +1,6 @@
+"""Vendor adapters. Each exposes `VENDOR`, `discover() -> list[Credential]` and
+`read(cred, now, get) -> reading`, where `get(url, headers, now)` returns a transport.Answer."""
+
+from . import anthropic, opencode, openai, xai, zai
+
+REGISTRY = {m.VENDOR: m for m in (anthropic, opencode, openai, xai, zai)}