TokenJuice: Wenn Agenten plötzlich weniger Token fressen

Agenten rufen ständig Terminalbefehle auf: git status, pnpm test, docker build. Die Resultate sind oft seitenlang, voll mit Log-Rauschen und fressen das Kontextfenster. TokenJuice setzt genau dort an – nach der Ausführung, nicht vorher.

Was TokenJuice macht

TokenJuice (tokenjuice) ist ein Open-Source-Plugin von Vincent Koch, das laute Tool-Ergebnisse kompaktiert, nachdem ein Befehl bereits gelaufen ist. Das unterscheidet es von Werkzeugen, die Commands selbst umschreiben: TokenJuice verändert den tool_result, der zurück an den Agenten geht. Das ursprüngliche Kommando bleibt unangetastet.

Der Ablauf ist schlicht: Ein Agent ruft ein Tool auf, TokenJuice fängt das Resultat ab, filtert redundante Informationen und gibt eine kleinere, strukturierte Payload zurück. Exit-Code und Prozesslauf bleiben dabei erhalten. Eine fehlgeschlagene Migration bleibt also ein Fehler, auch wenn ihr Log später kompakter aussieht.

Die Flags --raw und --full sind die Ausstiegstür, wenn das unveränderte Original gebraucht wird. Raw-Output kann lokal gespeichert werden, aber nur auf ausdrückliches Kommando.

Wo es passt

TokenJuice lässt sich laut Projekt als globales CLI-Tool über npm, pnpm, yarn oder Homebrew installieren. Mit tokenjuice install [codex|claude-code|cursor|pi] bindet es sich in die genannten Umgebungen ein; eine --local-Option ist ebenfalls vorgesehen.

Für OpenClaw sollte die Verfügbarkeit in der eigenen Installation geprüft werden, statt sie aus einem allgemeinen Tool-Artikel abzuleiten. Sinnvoll ist ein kleiner Testlauf mit einem unkritischen Kommando: Erst den normalen Output festhalten, dann prüfen, ob die Kürzung im erwarteten Tool-Pfad greift und ob --raw das vollständige Protokoll zuverlässig zugänglich macht.

Für welche Outputs es greift

TokenJuice komprimiert laute exec- und bash-Ergebnisse, bevor sie in die Session zurückfließen. Ein konkreter Fall sind Pi embedded runs: Dort kann der eingebaute tool_result-Pfad abgefangen werden, bevor der Output das Kontextfenster überlädt.

Das CLI bietet Diagnose-Kommandos: tokenjuice ls listet gecachte Artefakte, tokenjuice cat zeigt sie an, tokenjuice verify prüft die Installation und tokenjuice doctor sucht nach Hook-Problemen. tokenjuice stats liefert Nutzungsstatistiken. Für Betriebsteams sind diese Befehle mehr als Komfort: Sie helfen zu unterscheiden, ob ein Problem vom eigentlichen Tool stammt oder von der Ausgabeaufbereitung.

Die Architektur dahinter

Zwei Modi steuern die Komprimierung:

• reduce: Deterministische Zusammenfassung des Outputs – gleiche Eingabe, gleiches Ergebnis.
• wrap: Packt das Ergebnis in eine strukturierte Hülle, die JSON-parseable bleibt.

TokenJuice ist library-first angelegt und nicht an ein einzelnes Framework gebunden. Die dateibasierten Artefakte helfen beim Debugging. Wenn ein Agent eine falsche Schlussfolgerung zieht, lässt sich nachvollziehen, welcher Output gekürzt wurde und ob die relevante Zeile noch vorhanden war.

Die eigentliche Betriebsentscheidung

Das Problem ist alt, aber im Agentenbetrieb teuer: Ein git status in einem großen Repository liefert leicht Hunderte Zeilen, von denen nur wenige für den nächsten Schritt zählen. Verbose-Logs von pnpm test können eine Session mit Details füllen, obwohl ein einzelner fehlgeschlagener Test entscheidend ist.

TokenJuice spart Tokens durch deterministische Output-Komprimierung. Das hilft, solange der gekürzte Teil tatsächlich Rauschen ist. Bei einem kaputten Build, einem schwer erklärbaren Deployment-Fehler oder einem Sicherheitsvorfall kann jedoch gerade der unscheinbare Abschnitt im vollständigen Log die Ursache zeigen.

Ich würde Komprimierung deshalb für Routine-Outputs aktivieren, aber nie als Ersatz für Diagnose behandeln. Die Mindestregel ist klar: Bei wiederholten Fehlern, unerwarteten Exit-Codes und sicherheitsrelevanten Vorgängen gehört --raw in den Prüfpfad. TokenJuice löst kein Verständnisproblem des Agenten; es entscheidet nur mit darüber, wie viel Material der Agent überhaupt sehen muss. Genau darin liegt sein Nutzen – und seine Grenze.