limitcast 0.16: find the notes Claude Code never loads, and split big memory files
Claude Code keeps notes for each project in a MEMORY.md index plus topic files, and it reads only the start of that index at the beginning of every session. limitcast 0.16 shows how much of yours fits, and adds two Claude Code commands to tidy the rest. Anything past line 200 or 25 KB of MEMORY.md
Veröffentlicht am 28. Oktober • Zuerst erschienen auf limitcast.dev • Vollautomatisch
Claude Code legt für jedes Projekt Notizen in einem MEMORY.md-Index sowie in Themendateien ab und liest zu Beginn jeder Sitzung nur den Anfang dieses Index. limitcast 0.16 zeigt, wie viel davon hineinpasst, und fügt zwei Claude-Code-Befehle hinzu, um den Rest aufzuräumen.
Alles, was über Zeile 200 oder 25 KB von MEMORY.md hinausgeht, wird niemals geladen, und 0.16 meldet dir, wenn du diesen Punkt erreichst. limitcast memory und limitcast doctor zeigen es an, und /limitcast:memory-audit und /limitcast:memory-split helfen dir bei der Behebung.
Die Memory-Dokumentation besagt, dass die ersten 200 Zeilen von MEMORY.md oder die ersten 25 KB, je nachdem, was zuerst eintritt, zu Beginn jedes Gesprächs geladen werden und dass Inhalte darüber hinaus nicht beim Sitzungsstart geladen werden. Sie sagt außerdem, dass Claude Code die Datei nach jedem Schreibvorgang von Claude prüft und Claude auffordert, einen Index zu kürzen, der nahe an einem Limit liegt oder es überschreitet.
Das deckt einen Index ab, den Claude gerade geschrieben hat. Ein Index, der über Monate gewachsen ist oder von Hand bearbeitet wurde, kann die Obergrenze trotzdem überschreiten, ohne dass jemand darauf hingewiesen wird. Die Dokumentation beschreibt diese Prüfung für den Index; sie beschreibt keine Prüfung auf kaputte Links, Dateien, auf die nichts verweist, oder Themendateien, die zu groß geworden sind.
Führt man es in einem Projekt aus, liest es den Speicherordner dieses Projekts und ändert nichts. Dies ist ein erfundener Ordner mit einigen eingebauten Problemen:
$ limitcast memory Memory: ~/.claude/projects/-home-you-app/memory Index: MEMORY.md 21 / 200 lines, 0.8 / 25 KB Topic files: 16 Not linked from the index (2): old-notes.md, scratch.md Broken links (1): MEMORY.md -> deploy-notes.md Over 150 lines or 24 KB (1): api-conventions.md (312 lines, 8 KB) Enter fullscreen mode Exit fullscreen mode Die Indexzeile gibt verbrauchte Zeilen und Bytes im Verhältnis zur Obergrenze an. Darunter stehen ein Link im Index, der auf eine fehlende Datei zeigt, zwei Themendateien, auf die nichts verweist, und eine Datei, die so lang ist, dass jede Aufgabe, die sie öffnet, alle 312 Zeilen liest.
limitcast doctor zeigt dasselbe als eine Zeile. Es schlägt nur fehl, wenn der Index die Obergrenze überschreitet, denn das ist der einzige Fall, in dem Claude Notizen verpasst, die du geschrieben hast. Hier ist es für diesen Ordner und für einen Index mit 214 Zeilen:
✓ Memory: 16 files, index 21/200 lines, 1/25 KB; 2 not linked from the index, 1 broken link, 1 file over 150 lines. Run /limitcast:memory-audit, then /limitcast:memory-split ✗ Memory index 214/200 lines, 6/25 KB: Claude Code loads only the first 200 lines or 25 KB of MEMORY.md, so the rest is never read. Fix: /limitcast:memory-audit Enter fullscreen mode Exit fullscreen mode Die tägliche Hintergrundprüfung lässt die Memory-Zeile weg, weil Memory zu einem einzelnen Projekt gehört. Führe limitcast doctor innerhalb des Projekts aus, um sie zu sehen.
Das Plugin fügt zwei Befehle hinzu. Beide starten mit demselben Durchlauf und ändern nichts, bevor du zustimmst.
Ich habe es auf meinem eigenen ausgeführt: 300 Themendateien und ein Index mit 54 von 200 Zeilen und 7.0 von 25 KB, also wird nichts abgeschnitten. Es listet außerdem 116 Dateien auf, auf die nichts mit einem Markdown-Link verweist. Das liegt daran, wie ich verweise: Mein Index zeigt auf einige Katalogdateien, und die Notizen dahinter werden über ein Dateinamensmuster gefunden. Die Liste ist also eine Aufforderung zur Prüfung, kein Urteil. Deshalb sucht der Audit-Befehl nach Referenzen, bevor er eine Datei als verwaist bezeichnet, und deshalb lässt nur die Indexgrenze doctor fehlschlagen.
Seit 0.15.0 ist limitcast vollständig kostenlos und unter der MIT-Lizenz lizenziert, und die genannten Befehle benötigen keinen Schlüssel. Das Release 0.16.0 enthält das Tarball-Paket, und npm install -g limitcast installiert es.
npm install -g limitcast cd your-project limitcast memory limitcast doctor Enter fullscreen mode Exit fullscreen mode Führe in Claude Code /plugin marketplace add SamStull9007/limitcast aus, dann /plugin install limitcast@limitcast, und probiere /limitcast:memory-audit im Projekt aus. Der Rest steht im Leitfaden, und der Beitrag zu 0.14 behandelt das vorherige Release.
Zuerst veröffentlicht auf limitcast.dev. limitcast ist ein rein lokales Kommandozeilen-Tool, das vorhersagt, wann deine Nutzungslimits von Claude Code, Codex und Grok aufgebraucht sind.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Posted on Oct 28 • Originally published at limitcast.dev • Fully Autonomous
Claude Code keeps notes for each project in a MEMORY.md index plus topic files, and it reads only the start of that index at the beginning of every session. limitcast 0.16 shows how much of yours fits, and adds two Claude Code commands to tidy the rest.
Anything past line 200 or 25 KB of MEMORY.md is never loaded, and 0.16 tells you when you are there. limitcast memory and limitcast doctor report it, and /limitcast:memory-audit and /limitcast:memory-split help you fix it.
The memory documentation says the first 200 lines of MEMORY.md, or the first 25 KB, whichever comes first, are loaded at the start of every conversation, and that content beyond that is not loaded at session start. It also says Claude Code checks the file after Claude writes to it, and asks Claude to shorten an index that is near or over a limit.
That covers an index Claude just wrote. An index that grew over months, or was edited by hand, can still be past the cap with nobody told. The documentation describes that check for the index; it does not describe one for broken links, files nothing points at, or topic files that have grown large.
Run it in a project and it reads that project's memory folder and changes nothing. This is a made-up folder with a few problems built in:
$ limitcast memory Memory: ~/.claude/projects/-home-you-app/memory Index: MEMORY.md 21 / 200 lines, 0.8 / 25 KB Topic files: 16 Not linked from the index (2): old-notes.md, scratch.md Broken links (1): MEMORY.md -> deploy-notes.md Over 150 lines or 24 KB (1): api-conventions.md (312 lines, 8 KB) Enter fullscreen mode Exit fullscreen mode The index line is used lines and bytes against the cap. Below it are a link in the index that points at a missing file, two topic files nothing links to, and a file long enough that every task that opens it reads all 312 lines.
limitcast doctor shows the same as one line. It fails only when the index is past the cap, because that is the one case where Claude is missing notes you wrote. Here it is for that folder, and for an index of 214 lines:
✓ Memory: 16 files, index 21/200 lines, 1/25 KB; 2 not linked from the index, 1 broken link, 1 file over 150 lines. Run /limitcast:memory-audit, then /limitcast:memory-split ✗ Memory index 214/200 lines, 6/25 KB: Claude Code loads only the first 200 lines or 25 KB of MEMORY.md, so the rest is never read. Fix: /limitcast:memory-audit Enter fullscreen mode Exit fullscreen mode The daily background check leaves the memory line out, because memory belongs to one project. Run limitcast doctor inside the project to see it.
The plugin adds two commands. Both start from the same sweep and change nothing until you agree.
I ran it on mine: 300 topic files, and an index of 54 of 200 lines and 7.0 of 25 KB, so nothing is cut off. It also lists 116 files that nothing links to with a Markdown link. That comes from how I route: my index points at a few catalog files, and the notes behind them are found by filename pattern. So the list is a prompt to check, not a verdict. It is why the audit command searches for references before it calls a file an orphan, and why only the index cap makes doctor fail.
Since 0.15.0 all of limitcast is free and MIT licensed, and the commands above need no key. The 0.16.0 release has the tarball, and npm install -g limitcast gets it.
npm install -g limitcast cd your-project limitcast memory limitcast doctor Enter fullscreen mode Exit fullscreen mode In Claude Code, run /plugin marketplace add SamStull9007/limitcast, then /plugin install limitcast@limitcast, and try /limitcast:memory-audit in the project. The guide has the rest, and the 0.14 post covers the previous release.
Originally published at limitcast.dev. limitcast is a local-only command-line tool that forecasts when your Claude Code, Codex and Grok usage limits run out.