ctx: Sitzungshistorie von Coding-Agenten lokal durchsuchen

Warum Agenten-Transkripte verloren gehen und ctx sie zurückholt

Coding-Agenten haben Git-Historie, aber ihre eigenen Sitzungsprotokolle und Toolaufruf-Aufzeichnungen verschwinden in ausführlichen Logdateien. Diese Logdateien sind laut README ein Fundament nützlicher Daten, in unverständlichem Format für Agenten. Genau hier setzt ctx an: Die open-source-CLI indiziert die Sitzungshistorie, die ohnehin schon auf dem Rechner liegt, und macht Nachrichten und Toolaufrufe über Agenten und Sitzungen hinweg durchsuchbar, bis hin zum exakten Ereignis oder zum vollen Transkript.

Mit schneller Suche im Rücken können Agenten laut README Entscheidungen, Nebenbedingungen und Annahmen aus früherer Arbeit auftauchen lassen, bereits untersuchte Lösungswege und gescheiterte Ansätze finden, frühere Sitzungen im Detail auditieren und an der Stelle weiterarbeiten, an der andere Threads aufhörten. Das verspricht weniger wiederholte Agentenarbeit, niedrigere Tokenkosten und bessere Aufgabenergebnisse. Der Unterschied zu sogenanntem Agent-Memory ist laut README klar: Memory verdichtet Vergangenes zu Fakten und Zusammenfassungen, die veralten; ctx liefert dem Agenten das echte Protokoll ohne verlustreichen Zwischenschritt. Zusätzlich versteht ctx die Beziehungen zwischen Elternsitzungen, Subagenten und Forks, sodass die ganze Arbeitskette rekonstruierbar bleibt.

Installation, ctx setup und die Befehlsfläche

Auf macOS und Linux installiert der Befehl curl -fsSL https://ctx.rs/install | sh, unter Windows PowerShell läuft irm https://ctx.rs/install.ps1 | iex. Alternativ kann man den eigenen Agenten mit dem Satz Please install and set up ctx CLI (see github.com/ctxrs/ctx) beauftragen. Nach der Installation liest ctx setup die vorhandenen Quellen ein, ohne sie zu verändern.

Die tägliche Arbeit läuft über drei Kernbefehle. ctx search findet relevante Historie in normaler Sprache, etwa ctx search "failed migration", eingeengt mit --file crates/foo/src/lib.rs oder mehreren --term-Angaben. ctx show event <ctx-event-id> --window 3 druckt den passenden Ausschnitt des alten Transkripts, ctx show session liefert das volle Protokoll, und ctx locate identifiziert, woher ein Treffer stammt. Jede Sitzung und jedes Ereignis erhält eine stabile ctx-ID wie ses_01h... oder evt_01h... und behält den vollständigen Transkriptinhalt samt Quellinformation. Die Ergebnisseite listet Sitzungen, Schnipsel und ctx-IDs auf, sodass der Agent gezielt weiterlesen kann.

Architektur: SQLite-Index, BM25 und semantische Suche

Die alten Agentensitzungen leben laut README meist in JSONL-Dateien oder SQLite-Datenbanken unter Verzeichnissen wie ~/.claude und ~/.codex. ctx setup entdeckt diese Quellen und wandelt das Anbieterformat in einheitliche lokale Datensätze für Sitzungen, Nachrichten, Toolaufrufe, Beziehungen und Repository-Aktivität um, die dann lokal gespeichert und indiziert werden. Hooks oder Code im Agentenprozess sind nicht nötig; die automatische Indexierung ist voreingestellt und hält den Index aktuell, sobald sich die Historie ändert.

Wichtig für Konsistenz: Jede Aktualisierung wird abgeschlossen, bevor sie sichtbar wird, sodass Befehle nie einen halbfertigen Index lesen. Die Suche nutzt standardmäßig BM25 lexikalisches Matching; man gibt wahrscheinliche Begriffe ein, einen Fehler, eine Datei, einen Befehl oder eine Entscheidung. Für anders formulierte Verwandtschaften gibt es semantische Suche, die Embeddings lokal berechnet und direkt durchsucht, ohne eine Vektordatenbank zu betreiben. Aktiviert wird sie mit ctx semantic enable und geprüft mit ctx semantic status; mit --wait wartet man auf die Bereitschaft des lokalen Modells. Das Projekt ist in Rust geschrieben, steht unter Apache-2.0, zählt 1049 Sterne und lieferte am 28. August 2026 das Release v1.2.2 aus, nach v1.2.1 und v1.2.0 am selben Tag davor.

50x token-effizienter: die Kostenaussage des Projekts

Eine der kühnsten Aussagen des README steht in einer eigenen Überschrift: ctx sei 50x token-effizienter als rohe Transkriptsuche. Die Begründung: Indem Agentenhistorie in Sitzungen, Ereignisse, Metadaten und indizierte Felder strukturiert wird und die Suche gerankte Treffer mit Belegen zurückgibt, gelangen Agenten mit deutlich weniger Token an sinnvolle Historie. Das Projekt räumt selbst ein, dass Ergebnisse je nach Abfrage und Korpus variieren, aber rohe Suche sei oft so tokenlastig, dass sie faktisch dasselbe sei wie keine nutzbare Historie.

Für die Bewertung heißt das: Die 50x-Zahl ist eine Projektaussage aus dem README, keine unabhängige Messung. Wer den Wert im eigenen Setup prüfen will, kann dieselbe Frage einmal mit ctx search und einmal mit direktem grep durch die JSONL-Dateien stellen und den Tokenverbrauch der Antworten vergleichen. Das Argument selbst ist nachvollziehbar, denn gerankte Zitate mit ctx-IDs ersetzen das Durchblättern ganzer Protokolldateien im Kontextfenster.

ctx pro: git blame für Agentensitzungen für 20 Dollar im Monat

Die Bezahlstufe ctx pro vermarktet sich als git blame, aber für Agentensitzungen. git blame nennt den Commit, der eine Zeile zuletzt änderte; ctx blame nennt die Agentensitzung, die diesen Commit erzeugte, mit exakten Belegen zurück zum Originaltranskript. Startpunkte sind eine Datei mit Zeilenbereich wie ctx blame file src/checkout.ts --lines 118:146, ein Commit über ctx blame commit <sha> oder ein Pull Request über ctx blame pr https://github.com/your-org/your-repo/pull/42.

Das README-Beispiel zeigt den Ablauf: Die Ausgabe nennt Commit 8f3c2a1 und die erzeugende Sitzung c0297b8a-2ad7-4f73-a826-8ee9387cd1f4 mit Belegen [1] [2], danach öffnet ctx show session das Transkript und der Agent findet den ursprünglichen Grund, etwa warum mehrere Warenkorbzeilen mit derselben Produkt-ID auftraten. Wichtig ist die Ehrlichkeitsklausel: Liegt die Sitzung nicht auf dem eigenen Rechner, weil der Code vom Agenten eines Kollegen stammt, sagt ctx ausdrücklich, dass es die Zuordnung nicht belegen kann. ctx pro kostet 20 US-Dollar pro Monat, eine zweiwöchige kostenlose Testphase läuft ohne Konto oder Kreditkarte; frische interaktive Installationen starten die Testphase automatisch, Bestandsnutzer aktivieren sie mit ctx pro. Details stehen in docs/managed-companion.md.

Datenschutz, Grenzen und SDKs für sieben Sprachen

Alles läuft lokal: Indexierung, Suche und blame, sodass Code und Historie laut README den Rechner nie verlassen. Die Sitzungsquellen werden nur gelesen, nicht verändert. Ein Punkt verdient Wachsamkeit: Der Index ist lokal und privat standardmäßig, aber der Transkripttext wird bewahrt, statt lokale Pfade oder verdächtig nach Zugangsdaten aussehende Zeichenketten zu verstecken. Wer Ausgaben kopiert und teilt, sollte sie vorher prüfen, so das README wörtlich. In Teams bedeutet das, dass ctx-Berichte dasselbe Vorsichtsmaßnahmen-Niveau brauchen wie Roh-Logs.

Außerhalb der CLI gibt es SDKs, mit denen ctx agent history search aus TypeScript, Python, Rust, Go, JVM, Swift oder .NET-Code nutzbar wird. Das eröffnet, Sitzungssuche in eigene Werkzeuge und Workflows einzubauen, etwa ein Dashboard über frühere Fehlersuchen. Grenzen nennt das README dort, wo sie liegen: Die 50x-Effizienz ist abfrageabhängig, und die Belegkraft von blame endet an der eigenen Maschine. Die Projektwebsite ctx.rs dokumentiert die Einstiegsschritte, und der Standardbranch ist main.

Fazit: Für welche Agenten-Workflows ctx die Wiederholung stoppt

ctx löst ein konkretes, alltägliches Problem: Agentenwissen steckt in Transkripten auf der eigenen Platte, und jede neue Sitzung beginnt bei null, weil diese Protokolle in dieser Form nicht auffindbar sind. Die Befehlskette ctx setup, ctx search, ctx show ist klein genug für den sofortigen Einstieg, und semantische Suche mit ctx semantic enable hebt die Hürde, wenn man sich an die alte Formulierung eines Fehlers nicht mehr erinnert.

Für Einzelpersonen mit intensiver Agentennutzung ist die Gratisstufe vermutlich bereits der Mehrgewinn, denn Indexierung und Suche laufen lokal und ohne Kontingent. ctx pro mit ctx blame lohnt vor allem in Teams, die nachvollziehen müssen, warum Code in einem bestimmten Commit so entstanden ist, und dafür 20 US-Dollar im Monat kalkulieren. Bevor man sich darauf verlässt, sollte man mit der eigenen Historie einen realen Rückblicksspielfall durchspielen: Einen bekannten früheren Fehler per ctx search suchen, das Transkript mit ctx show öffnen und prüfen, ob die Belegkette bis zum ursprünglichen Toolaufruf reicht. Genau das ist der Wertversprechen-Kern, und nur der eigene Korpus entscheidet, ob er hält.

Redaktionelles Fazit

ctx passt zu Entwicklern, die mit Claude Code, Codex oder vergleichbaren Agenten arbeiten und wiederholte Recherche vermeiden wollen, weil jede neue Sitzung die alte Historie auf der Platte auswerten kann. Unpassend ist es, wenn keine Agenten-Transkripte auf dem Rechner liegen oder Transkripttext nie den Rechner verlassen darf, denn die Ausgabe bewahrt Pfade und geheimnisähnliche Zeichenketten. Vor dem Alltagseinsatz lohnt ctx setup und ein Test mit ctx search nach einem bekannten früheren Fehlerbild.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes