Erste Schritte

OpenLimiter ist ein Quota Meter für die KI Abos, die du ohnehin bezahlst. Es läuft auf deinem Rechner, liest, was deine Tools dort schon geschrieben haben, und gibt deinen Coding Agenten ein begrenztes Bild davon, was an Budget übrig ist.

Was du brauchst

Node 24 oder neuer.
npm, das mit Node mitgeliefert wird.

Alles läuft lokal. Es wird kein Konto angelegt, kein Key ist zum Start nötig, und keine Anfrage verlässt deinen Rechner bei irgendeinem der folgenden Schritte.

OpenLimiter installieren

Installier das Kommandozeilen Tool global, dann führ seine synthetische Demo aus.

Terminal

npm install -g openlimiter
openlimiter demo

openlimiter demo rendert synthetische Fixtures. Es beweist, dass die Binary funktioniert, ohne ein echtes Konto anzufassen, und jede Zahl, die es ausgibt, ist erfunden.

Gib ihm etwas zum Messen

OpenLimiter kontaktiert in diesem Release nie einen Provider. Es parst Daten, die etwas anderes ihm bereits vorgelegt hat. Bis einer der Ingestionswege läuft, meldet jeder Befehl ehrlich unknown.

Der Weg, der keine zusätzliche Arbeit braucht, ist die Claude Code Statusline. Claude Code führt deinen Statusline Befehl bei jedem Rendern aus und schreibt ein JSON Objekt, das die aktuelle Session beschreibt, an die Standardeingabe dieses Befehls. Trägt dieses Objekt einen Rate Limit Block, validiert OpenLimiter ihn, cacht ihn, und rendert die frischen Zahlen im selben Aufruf.

Terminal

openlimiter statusline < session.json
OpenLimiter NEAR_CAP NONE UNKNOWN OPENROUTER,CODEX,ANTIGRAVITY,OPENCODE,MANUAL  CLAUDE ####. 87.5%

Nicht jede Claude Code Version sendet Rate Limit Felder. Tut deine das nicht, bleibt dieser Weg still, und die beiden manuellen Wege funktionieren trotzdem. Die Ingestion Seite deckt alle drei ab.

Claude Code verdrahten

Füg das zu deiner Claude Code settings.json hinzu. Die globale Installation macht den Befehl openlimiter für Claude Code verfügbar.

settings.json

{
  "statusLine": {
    "type": "command",
    "command": "openlimiter statusline"
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "openlimiter hook"
          }
        ]
      }
    ]
  }
}

Aus dem Quellcode beitragen

Nutz die Toolchain des Repositorys, wenn du beitragen willst.

Terminal

git clone https://github.com/lucaswebsystems/openlimiter
cd openlimiter
pnpm install
pnpm build
pnpm typecheck
pnpm test
node packages/cli/dist/bin.js demo

Der Build muss vor der Type Check laufen, weil jedes Paket seine Nachbarn über die Declaration Files auflöst, die der Build erzeugt.

Wie geht es weiter

Eine sinnvolle Lesereihenfolge

1Warum OpenLimiter für das Problem, das es löst.
2Unterstützte Provider dafür, was jeder Connector liest und wie zerbrechlich er ist.
3Agent context dafür, was genau deinen Agenten erreicht.
4CLI Referenz für jeden Befehl und jeden Exit Code.