Was ist stalemap?
stalemap findet die npm-Abhängigkeiten eines Projekts, deren APIs sich nach dem Trainingsstichtag des Modells geändert haben, und gibt diese Änderungen an den Coding-Agenten weiter. Es ermittelt den Stichtag des konfigurierten Modells über models.dev, nimmt das neueste stabile Release, das mindestens 30 Tage davor erschien, als das, was das Modell kennt, und vergleicht es mit der Version, die du festlegst.
Für den Vergleich lädt es die .d.ts-Typdateien beider Versionen und vergleicht sie mit der TypeScript-Compiler-API, dazu Breaking-Change-Einträge aus Changelogs und GitHub Releases. Der Agent bekommt das Ergebnis auf drei Wegen: einen gewichteten Notizblock in AGENTS.md oder CLAUDE.md (standardmäßig 1.800 Tokens), einen Wächter, der nach jeder Änderung das projekteigene tsc ausführt und jedem Fehler die passende Notiz beilegt, und ein MCP-Tool search_changes.
Es gibt es als npm-Paket, als Claude-Code-Plugin, als GitHub Action und mit Setup-Befehlen für Cursor, Codex und OpenCode. Der Code steht unter MIT, das Repository wurde am 19. Oktober 2026 angelegt, und das neueste Release ist 0.4.1 vom 20. Oktober.
Lohnt sich stalemap?
stalemap zielt auf einen bestimmten Fehler: Ein Agent schreibt Code für die Version einer Bibliothek, auf der er trainiert wurde, nicht für die, die du festlegst. Die Beispiele im README sind maxSteps gegenüber AI SDK 7, required_error gegenüber zod 4 und middleware.ts gegenüber Next 16. Statt ganze Dokumentationsseiten zu holen, vergleicht es die Typdefinitionen beider Versionen und gibt dem Agenten nur, was sich an den APIs geändert hat, die dein Code importiert.
Die Belege sind besser als bei den meisten Agenten-Tools. In einem blinden, vorab registrierten Test mit 66 Aufgaben aus Änderungen, die 33 populäre npm-Pakete zwischen Juli und Oktober 2026 veröffentlicht haben, bestand claude-sonnet-5-5 89 % der Sitzungen mit stalemap, gegenüber 68 % allein und 73 % mit einem einfachen tsc --noEmit-Hook nach jeder Änderung; das Intervall für den Hauptvergleich lag bei 13,6 bis 28,3 Punkten. Der Autor nennt auch die Obergrenze: Ein handgeschriebener Einzeiler, der die Änderung benennt, erreichte 98 %. Tool, Testumgebung und Protokolle stammen vom selben Autor, die Aufgaben schrieb aber eine getrennte Sitzung, und ein unabhängiger Prüfer kontrollierte sie; gemessen wurden nur zwei Claude-Modelle.
Kostenlos im Betrieb ist es nicht. Die mittleren Kosten pro Sitzung stiegen bei claude-sonnet-5-5 von $0.041 auf $0.050 und bei claude-sonnet-4-5 von $0.085 auf $0.124, wobei Sitzungen 79 statt 47 Sekunden dauerten. Code verlässt den Rechner nie, aber Paketnamen und Versionen gehen an die npm-Registry, GitHub und models.dev, und die optionalen Modi --llm, --examples und --guides schicken Typ-Diffs und die Namen importierter APIs an Claude.
Die Grenzen stehen offen im README: ein package.json ohne Workspace-Unterstützung, kein Vergleich von @types-Paketen, Nutzungsverfolgung, die bei importierten Namen und x.member-Zugriffen endet, und ein Setup für Cursor, Codex und OpenCode, das in keiner echten Installation erprobt wurde. Context7 deckt mehr Sprachen ab, indem es aktuelle Dokumentation auf Abruf liefert; stalemap ist das strengere Werkzeug, weil der Wächter beim Bearbeiten veraltete Aufrufe auch dann erwischt, wenn der Agent gar nicht auf die Idee kommt nachzufragen.
Wo es sich lohnt
Ein Solo-Entwickler an einer App mit Next.js 16 und AI SDK 7, der Claude Code nutzt
Verhindern, dass der Agent middleware.ts- und maxSteps-Code schreibt, der nicht mehr kompiliert
Das Claude-Code-Plugin mit zwei /plugin-Befehlen installieren; die Notizen laden beim Sitzungsstart, und der Wächter meldet nach jeder Änderung Kompilierfehler mit der Lösung. Sitzungen werden etwas teurer, im Median etwa $0.009 pro Aufgabe bei claude-sonnet-5-5.
Ein Tech Lead in einer TypeScript-Agentur mit 20 Entwicklern
Agenten-Anweisungen aktuell halten, wenn Renovate eine Hauptversion hochzieht
Den Notizblock committen und dann die GitHub Action mit einem model-Eingabewert einbinden: npx stalemap check lässt CI scheitern, wenn der Block veraltet ist, oder der Kommentarmodus schreibt bei Pull Requests mit Abhängigkeitsänderungen, was sich geändert hat. Der Kommentarmodus braucht pull-requests: write.
Eine Entwicklerin, die Cursor oder Codex statt Claude Code nutzt
Dem Agenten bei der Arbeit aktuelle API-Änderungen auf Abruf geben
stalemap setup --agent cursor (oder codex) ausführen, um die Notizen zu schreiben, den MCP-Server zu registrieren und den Wächter nach Änderungen als Projektdateien zu installieren. Laut Autor wurde dieser Weg noch in keiner echten Cursor- oder Codex-Installation erprobt.
Bevor du dich festlegst
- Einrichtung
- /plugin marketplace add Umair/stalemap und dann /plugin install stalemap@stalemap in Claude Code, oder npx stalemap für die Vorschau und npx stalemap sync zum Schreiben des Blocks; jeder MCP-Client kann npx -y stalemap@latest mcp ausführen.
- Integrationen
- Vier MCP-Tools (search_changes, package_changes, project_changes, check_notes); Claude-Code-Hooks für SessionStart und PostToolUse; Setup für Cursor, Codex und OpenCode; eine GitHub Action; Lockfiles von npm, pnpm, yarn und bun.
- Daten und Datenschutz
- Quellcode wird lokal gescannt und nie hochgeladen. Paketnamen und Versionen gehen an die npm-Registry, GitHub und models.dev; --llm, --examples und --guides senden Typ-Diffs, Auszüge aus Release Notes und Namen importierter APIs an Claude. Caches liegen in ~/.cache/stalemap. MIT.
- Kosten im großen Maßstab
- Das Tool ist kostenlos. Im Benchmark des Autors stiegen die mittleren Kosten pro Sitzung bei claude-sonnet-5-5 von $0.041 auf $0.050 und bei claude-sonnet-4-5 von $0.085 auf $0.124; optionale, von Claude geschriebene Zusammenfassungen verursachen API-Aufrufe auf deinem Schlüssel.
- Grenzen
- Nur JavaScript und TypeScript; ein package.json; @types-Pakete werden nicht verglichen; Verhaltensänderungen werden nur erkannt, wenn Release Notes oder Upgrade-Guides sie nennen; Agenten ignorieren manchmal korrekte Notizen.
Was gut ist
- Vergleicht echte Typdefinitionen, keine Modell-Zusammenfassung von Dokumentation
- Wächter beim Bearbeiten koppelt jeden Compilerfehler mit der passenden Änderungsnotiz
- Blinder, vorab registrierter Benchmark mit Obergrenze und Kosten
- Quellcode wird nie hochgeladen; der Scan läuft lokal
- Claude-Code-Plugin, MCP-Server, CLI und GitHub Action
Was nicht
- Nur JavaScript und TypeScript; ein package.json, keine Workspaces
- Erhöht die mittleren Sitzungskosten, etwa 22 % bei claude-sonnet-5-5
- Setup für Cursor, Codex und OpenCode in echten Installationen ungetestet
- Ein Maintainer; angelegt am 19. Oktober 2026
Am besten für
TypeScript-Entwickler, deren Coding-Agent immer wieder Code für ältere Versionen schnelllebiger Pakete wie Next.js, das AI SDK oder zod schreibt.
stalemap: häufige Fragen
- Lohnt sich stalemap?
- Eine schmale Lösung für ein echtes und teures Problem, mit einem ungewöhnlich sorgfältigen Benchmark dahinter, aber nur für JavaScript und TypeScript und nur von einem Maintainer. Wir bewerten es mit 3.8 von 5.
- Was kostet stalemap?
- Kostenlos unter MIT. Die optionalen Funktionen --llm, --examples und --guides rufen Claude über deinen eigenen Anthropic-Schlüssel oder dein Claude-Code-Login auf.
- Welche Nachteile hat stalemap?
- Nur JavaScript und TypeScript; ein package.json, keine Workspaces; Erhöht die mittleren Sitzungskosten, etwa 22 % bei claude-sonnet-5-5; Setup für Cursor, Codex und OpenCode in echten Installationen ungetestet; Ein Maintainer; angelegt am 19. Oktober 2026.
- Für wen eignet sich stalemap?
- TypeScript-Entwickler, deren Coding-Agent immer wieder Code für ältere Versionen schnelllebiger Pakete wie Next.js, das AI SDK oder zod schreibt.
- Was kostet stalemap für ein Team oder im Produktivbetrieb?
- Das Tool ist kostenlos. Im Benchmark des Autors stiegen die mittleren Kosten pro Sitzung bei claude-sonnet-5-5 von $0.041 auf $0.050 und bei claude-sonnet-4-5 von $0.085 auf $0.124; optionale, von Claude geschriebene Zusammenfassungen verursachen API-Aufrufe auf deinem Schlüssel.
- Ist stalemap sicher für Firmendaten?
- Quellcode wird lokal gescannt und nie hochgeladen. Paketnamen und Versionen gehen an die npm-Registry, GitHub und models.dev; --llm, --examples und --guides senden Typ-Diffs, Auszüge aus Release Notes und Namen importierter APIs an Claude. Caches liegen in ~/.cache/stalemap. MIT.
Antworten geprüft am 5. Nov. 2026.