Wie Rationale funktioniert, und was Ihren Rechner verlässt

1 · Erfassen: wenn ein Turn endet

Installieren Sie den Client einmal pro Laptop. Von da an führt Ihr Agent jedes Mal, wenn er einen Turn beendet, den Stop-Hook des Clients aus (Claude Code; Codex, sobald Sie den Hooks vertraut haben). Der Hook startet eine Erfassung im Hintergrund und kehrt sofort zurück, sodass der Agent nie wartet. Ein Watcher tut jede Minute dasselbe für jeden Turn, den ein Hook verpasst hat: ein Absturz, ein geschlossenes Fenster, eine Sitzung, die eine Minute lang still ist und neue Turns hat.

Die Erfassung liest das Transkript der Sitzung auf Ihrem Rechner und baut ein kompaktes Delta der neuen Turns: Ihre Nachrichten, die Antworten des Agenten und die Tools, die er aufgerufen hat, mit ihrer Eingabe auf 200 Zeichen gekürzt. Tool-Ausgaben, Thinking und der Text, den der Agent von sich aus einfügt, bleiben draußen. Bis zu 120 Turns gehen in einen Block, mit bis zu 30 früheren Turns als Nur-Lese-Kontext, damit ein kurzer Block nicht isoliert gelesen wird.

Das Delta geht an die eigene CLI des Agenten auf Ihrem Rechner, angemeldet als Sie: claude -p für eine Claude-Code-Sitzung, codex exec für eine Codex-Sitzung. Eine Codex-Sitzung geht nie an Anthropic, und eine Claude-Code-Sitzung geht nie an OpenAI. Für Claude Code ist der Aufruf schlank: ein System-Prompt, ein JSON-Schema, keine Tools, keine Einstellungen, keine Hooks, keine MCP-Server, keine Sitzungsdatei, sodass er nie in Ihrem Verlauf auftaucht. Für Codex ist es das dokumentierte codex exec, flüchtig, schreibgeschützt, in einem leeren Ordner, mit den eigenen Hooks des Clients abgeschaltet.

Erfasst werden nur Sitzungen in einem Repository, das eines Ihrer Projekte listet. Der Client fragt Rationale, welcher Ihrer Workspaces das Git-Remote des Repositorys listet, und merkt sich die Antwort zehn Minuten. Kein Projekt: Nichts wird extrahiert und nichts gesendet. Zwei Workspaces: ebenfalls nichts, und rationale status nennt beide. Eine fehlgeschlagene Extraktion wird nach 5, dann 15, dann 60 Minuten wiederholt, solange derselbe Block fehlschlägt, und blockiert den Agenten nie.

Was Rationale erreicht, ist das Ergebnis: die Entscheidungen, dazu Sitzungs-ID und -Titel, Turn-Nummern, Repository, Branch, Commit, der Zeitpunkt des letzten Turns, Agent, Modell, Dauer, Tokens und Kostengegenwert. Der Endpunkt, der eine Erfassung entgegennimmt, hat kein Feld, das ein Transkript tragen könnte.

2 · Aufzeichnen: was eine Entscheidung enthält

Eine Entscheidung ist keine Zusammenfassung der Sitzung. Sie hat eine Frage, die Wahl, die Kriterien, die sie getrieben haben, mit ihrem Gewicht, die verworfenen Optionen und warum, Annahmen, und was das Team dazu bringen würde, sie zu überdenken. Sie ist an Pfade im Repository und an Bezeichner verankert (eine Klasse, eine Tabelle, einen Ticket-Key) und sagt, worum es geht: Business, Produkt oder Technik. Die eigenen Worte der Person, die sie entschieden hat, werden zitiert.

Jede Entscheidung wird als abgeleitet aufgezeichnet: Ein Agent hat sie extrahiert. Bestätigt wird sie nur durch eine Person: einen Klick in der App, ihre eigenen Worte in einer Sitzung (der Client prüft das Zitat gegen das Transkript, bevor er es sendet, sodass ein Agent, der sagt, jemand habe bestätigt, nicht genügt), oder den Merge des Pull Requests, der sie trug. Beide Herkünfte bleiben sichtbar, und Agenten sehen den Unterschied.

Entscheidungen werden pro Workspace nummeriert (D-42), als unveränderliche Versionen aufbewahrt und im Ruhezustand verschlüsselt. Der Server liest nur Bezeichner, Zustände, Anker und Zeitstempel. Jedes Lesen und jede Bestätigung wird in das Audit-Log des Workspace geschrieben. Der Extraktor meldet auch, wenn die Person im Gespräch eine frühere Entscheidung bestätigt, korrigiert oder zurückgezogen hat, und wenn der Agent nach einer gefragt hat.

Eine Sitzung, die keine Aufgabe genannt hat, schickt ihre Entscheidungen in den Eingang des Projekts, wo das Team sie verknüpft, behält oder zurückzieht. Eine Wiederholung einer bereits aufgezeichneten Entscheidung wird verknüpft, nicht zweimal aufgezeichnet.

3 · Kontext geben: #handle, Notizen und MCP

Eine Aufgabe ist ein #handle: ein lesbarer Slug, eindeutig im Workspace, an dem alles hängt: Sitzungen, Entscheidungen, Übergaben, Pull Requests, Tickets. Tippen Sie ihn in einen beliebigen Prompt, und der UserPromptSubmit-Hook schickt Rationale den Handle, das Repository und den Branch, sonst nichts aus dem Prompt. Zurück kommt der Kontext der Aufgabe: ihr Zustand, ihre aktiven Entscheidungen nach Bereich, ihre letzten Übergaben und ihre offenen Pull Requests. Die Sitzung wird mit der Aufgabe verknüpft, sodass ihre späteren Erfassungen dort landen.

Ein nach dem Handle benannter Branch verknüpft die Sitzung ebenfalls, ohne dass Sie etwas tippen. Wenn eine Sitzung startet, holt der SessionStart-Hook Ihre Notizen: ständige Anweisungen, die Sie Ihren Agenten gegeben haben („antworte mir auf Spanisch“, „fass die v1-Controller nie an“), für Workspace und Projekt dieses Repositorys, in höchstens 300 Tokens und zwei Sekunden. Dafür verlässt nur das Remote des Repositorys Ihren Rechner.

Assistenten ohne Hooks verbinden sich über MCP: Claude (claude.ai und die Desktop-App), ChatGPT, Cursor, Claude Code und Codex selbst, und jeder Client, der das Protokoll spricht. Der Remote-Server unter https://mcp.rationalehq.com/mcp nutzt OAuth 2.1 mit PKCE: URL einfügen, einmal anmelden, Ihre Workspaces freigeben. Es gibt keine API-Keys. Seine Tools sind context_for, search, list_tasks, list_inbox, list_notes, pull_request_for, record_decision, record_outcome, record_handoff, record_note, remove_note, open_task, set_visibility, answer_overlap und suggest_same_person; jedes erklärt, ob es liest oder schreibt, damit Ihr Client Sie vor einem Schreibvorgang fragen kann.

Business-Entscheidungen kommen zuerst, gefasst als Rahmen, den Produkt- und technische Entscheidungen nicht aufheben. Alles, was ein Agent über MCP aufzeichnet, ist abgeleitet, mit den zitierten Worten der Person, weil nichts ein Gespräch prüfen kann, das Rationale nicht gesehen hat.

4 · Warnen: vor der Änderung, nicht im Review

Der PostToolUse-Hook läuft nach jedem Tool-Aufruf und beendet sich in wenigen Millisekunden für Tools, die er nicht beobachtet. Er beobachtet Read, Edit, Write, MultiEdit und NotebookEdit sowie Bash-Befehle, die eine Datei nennen, weil Agenten mit cat, sed und grep so oft lesen wie mit Read; für Codex Shell-Befehle und apply_patch. Das Lesen ist der Moment, der zählt: Das Modell muss seine Änderung erst noch schreiben.

Der Hook hält einen Index der verankerten Entscheidungen des Repositorys, im Hintergrund beim Sitzungsstart und nach jedem Turn aufgefrischt: zu jeder Entscheidung Nummer, Pfade, Bezeichner, Bereich, Commit und Kurzfassung (Frage und Wahl). Er gleicht den Pfad der Datei auf Ihrem Rechner mit diesem Index ab und liest, für Entscheidungen, die eine Klasse, eine Tabelle oder einen Ticket-Key nennen, die Datei hier (Text, höchstens 512 KB), um danach zu suchen. Der Inhalt verlässt den Rechner nie. Eine Datei, auf die nichts passt, löst gar keine Anfrage aus.

Bei einem Treffer fragt eine einzige Anfrage Rationale nach dem Text der Warnung: das Repository, der Pfad relativ zum Repository, wie jede Entscheidung gepasst hat, welche Entscheidungen der Agent schon in seinem Kontext hat und, nach der Änderung einer Datei, die auch der offene Pull Request einer anderen Person ändert, die gerade geänderten Zeilen. Die Antwort kommt innerhalb von zwei Sekunden: höchstens drei Entscheidungen vollständig und der Rest nach Nummer, wer jede entschieden hat, ob eine Person sie bestätigt hat, und wie viele Commits die Datei seitdem berührt haben. Ist Rationale langsam oder nicht erreichbar, bekommt der Agent stattdessen die Kurzfassung aus dem lokalen Index. Jede gezeigte Warnung ist ein auditiertes Lesen.

Einmal pro Datei und Sitzung; erneut, wenn sich die Entscheidungen ändern. Eine Datei, deren Entscheidungen alle schon im Kontext des Agenten sind, bekommt keine Warnung. Es ist Kontext, nie eine Sperre: Der Hook ändert nie die Berechtigungen des Agenten und hält ihn nie an. Ein Hook, der fehlschlägt, beendet sich still.

Was Ihren Rechner verlässt

Eine Zeile pro Ereignis. Jede Zeile wurde am Quellcode des Clients (rationale-client 0.9.0) und an der API geprüft, die jede Anfrage entgegennimmt. Wo Ihre eigene CLI läuft, sagt die Zeile, was an den Anbieter Ihres Agenten geht: Dieser Verkehr geht dorthin, wohin Ihre Sitzungen ohnehin gehen, unter Ihrem eigenen Konto.

Der Inhalt von Entscheidungen, Notizen und Übergaben ist im Ruhezustand verschlüsselt, mit Schlüsseln, die getrennt von der Datenbank aufbewahrt werden. Unser Personal sieht Bezeichner, Zustände und Anker, nie den Inhalt, und jeder Blick unseres Personals wird in Ihr Audit-Log geschrieben. Die Sicherheitsseite hat die technische Sicht; die Datenschutzerklärung die rechtliche.

In zwei Minuten installieren

Ein Befehl, ohne sudo, macOS oder Linux. Er legt eine Binärdatei unter ~/.local/bin/rationale ab und sonst nichts: noch keine Hooks, keine Anmeldung.

curl -fsSL https://rationalehq.com/install.sh | sh

Oder mit Homebrew:

brew tap rationalehq/tap https://github.com/jorgebasilio/homebrew-tap
brew install rationalehq/tap/rationale

Dann, in einem Repository, das Ihr Workspace listet:

rationale init

1. Im Browser anmelden. Das Terminal zeigt einen Code und öffnet die Anmeldeseite der App. Eine Anmeldung pro Workspace; rationale login fügt eine weitere hinzu.
2. Dieses Repository. Es prüft, welcher Ihrer Workspaces das Git-Remote dieses Repositorys listet. Von einem gelistet: erfasst. Von keinem: Es sagt es und fragt, ob Sie es gerade gelistet haben.
3. Agenten auf diesem Rechner. Es schreibt die vier Hooks in die ~/.claude/settings.json von Claude Code (ein Backup bleibt erhalten; Ihre eigenen Einträge bleiben unberührt) und, wenn Codex da ist, in ~/.codex/hooks.json, und erklärt Ihnen den Vertrauensschritt, den Codex verlangt. Cursor wird erkannt und gemeldet, noch nicht erfasst.
4. Watcher. Ein launchd-Job unter macOS, ein systemd-User-Timer unter Linux, jede Minute: erfasst jeden Turn, den ein Hook verpasst hat, schreibt Übergaben, erstellt Zusammenfassungen und prüft auf Updates. Ohne systemd-User-Session erfassen die Hooks trotzdem jeden Turn.

Fertig. Arbeiten Sie wie gewohnt. rationale status zeigt jederzeit die Anmeldungen, den Workspace dieses Repositorys, die Hooks, den Watcher und die letzte Sitzung. Um aus Claude, ChatGPT oder Cursor zu lesen und aufzuzeichnen, fügen Sie den MCP-Server hinzu; die Dokumentation hat die Schritte für jeden Client. Für Claude Code:

claude mcp add --scope user --transport http rationale https://mcp.rationalehq.com/mcp

Die Hooks, und wie man sie entfernt

rationale init fügt dem Objekt hooks in ~/.claude/settings.json vier Einträge hinzu. Jeder führt die installierte Binärdatei mit dem Namen des Ereignisses aus; die Binärdatei entscheidet, was zu tun ist, sodass ein Update Ihre Einstellungen nie umschreibt. Die Zeitlimits sind das Höchste, was ein Hook brauchen darf; sie kehren weit früher zurück.

Ein Eintrag sieht so aus; der Befehl ist der absolute Pfad der Binärdatei, nie eine Suche im PATH:

"Stop": [{ "hooks": [{ "type": "command", "command": "/Users/you/.local/bin/rationale hook claude-code stop", "timeout": 10 }] }]

Ein Hook blockiert den Agenten nie: Jeder Fehler wird abgefangen und der Hook beendet sich mit 0; ein Absturz beendet sich mit einem Code, den Claude Code als nicht blockierenden Fehler anzeigt. Hooks tun nichts in einem Repository, das kein Projekt listet. Für Codex gehen die vier Einträge in ~/.codex/hooks.json, ebenfalls ohne Matcher; Codex führt sie erst aus, nachdem Sie ihnen vertraut haben (/hooks in der CLI, Review hooks in der App), und der Client schreibt dieses Vertrauen nie für Sie.

Um alles zu entfernen:

rationale uninstall

Es entfernt die vier Hooks aus Claude Code und aus Codex, behält ein Backup jeder Einstellungsdatei, und entfernt den Watcher. Widerrufen Sie dann das Gerät auf der Seite Devices der App, was sein Token ungültig macht. Die Konfiguration bleibt in ~/.config/rationale/ und der lokale Zustand in ~/.local/state/rationale/, bis Sie sie löschen; die Binärdatei ist eine einzelne Datei, die Sie entfernen können.

Agenten und Konnektoren heute

Was live ist, was in der Beta ist und was als Nächstes kommt. Wir nennen, was wir nicht abdecken, statt es zu unterstellen.

Early Access: Zugang anfragen, und wir richten Ihren Workspace mit Ihnen ein, innerhalb eines Werktags.