Rationale installieren und Ihre Agenten verbinden

So greifen die Teile ineinander

Rationale hat drei Teile. Einen Client auf dem Rechner jeder Person: eine einzige Binärdatei, keine Laufzeitumgebung, die den Agenten-Sitzungen der Person zuhört. Die App unter app.rationalehq.com, in der Entscheidungen, Aufgaben und Audit-Logs liegen und in der sich das Team anmeldet. Und einen Remote-MCP-Server unter mcp.rationalehq.com, über den Assistenten wie Claude, ChatGPT und Cursor Entscheidungen lesen und festhalten.

Der Client extrahiert Entscheidungen mit dem Agenten, bei dem die Person bereits angemeldet ist (claude -p für Claude Code, codex exec für Codex), auf diesem Rechner. Rationale erhält die extrahierten Entscheidungen, kurze Zitate und Metadaten: Sitzungs-ID, Turn-Nummern, Repository, Branch, Zeitpunkt. Das Transkript verlässt den Rechner nie, außer zum Anbieter des Agenten selbst, wie schon immer.

Bevor Sie anfangen

• macOS (eine universelle Binärdatei) oder Linux auf x86_64 oder arm64. Windows wird noch nicht unterstützt: Der Installer sagt das und bricht ab.
• Claude Code oder Codex, auf dem Rechner angemeldet. Der Client nutzt diese CLI, um Entscheidungen zu extrahieren, über den eigenen Tarif der Person; er braucht nie einen eigenen API-Schlüssel.
• Einen Rationale-Workspace. Wir sind im Early Access: Fragen Sie Zugang an, und wir richten den Workspace innerhalb eines Werktags gemeinsam mit Ihnen ein.
• Ein Projekt im Workspace, das das Git-Remote jedes Repositorys auflistet, das erfasst werden soll. Der Client ordnet jede Sitzung anhand dieses Remotes zu; ein Repository, das kein Projekt auflistet, wird nie erfasst.
• curl oder wget sowie sha256sum oder shasum, die jedes macOS und Linux mitbringt.

Den Client installieren

Ein Befehl, ohne sudo:

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

Der Installer legt eine Binärdatei unter ~/.local/bin/rationale ab. Der Download landet neben der Binärdatei; er prüft Größe und sha256 gegen das Release-Manifest, führt rationale --version aus und benennt die Datei an ihren Platz um. Er ändert Ihre Shell-Dateien nie: Wenn ~/.local/bin nicht in Ihrem PATH ist, gibt er die Zeile aus, die Sie hinzufügen müssen. Er meldet niemanden an und installiert keine Hooks; das erledigt rationale init, der nächste Schritt.

Alternativ mit Homebrew:

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

Die erste Installation vertraut TLS zum Datei-Host, wie jedes curl | sh. Jedes spätere Update prüft der Client selbst gegen ein signiertes Release-Manifest (siehe Updates, Rollback, Deinstallation).

Anmelden und einrichten: rationale init

Führen Sie es einmal pro Rechner aus, in einem Repository, das Ihr Workspace auflistet:

rationale init

1. Anmeldung. Es öffnet den Browser mit einem kurzen Code (der Device Flow). Sie melden sich bei Rationale an, und der Rechner erhält sein eigenes Token, abgelegt in ~/.config/rationale/config.json (Modus 600). Eine Anmeldung pro Workspace; rationale login fügt eine weitere hinzu.
2. Repository-Prüfung. Es fragt nach, welcher Ihrer Workspaces ein Projekt hat, das das Git-Remote dieses Repositorys auflistet. Genau einer: dort erfasst. Keiner: nicht erfasst, und es sagt das. Zwei: nicht erfasst, und rationale status nennt beide. Es rät nie.
3. Hooks. Für Claude Code schreibt es vier Einträge in ~/.claude/settings.json (ein Backup bleibt erhalten, Ihre eigenen Einträge bleiben unberührt): Stop, UserPromptSubmit, SessionStart und PostToolUse. Für Codex fügt es vier Einträge in ~/.codex/hooks.json hinzu; Codex führt einen Hook erst aus, nachdem Sie ihm vertraut haben (/hooks in der CLI oder Review hooks in der App), und init und status weisen darauf hin, bis das erledigt ist.
4. Watcher. Auf macOS ein launchd-Job (~/Library/LaunchAgents/com.rationalehq.client.watcher.plist), auf Linux ein systemd-User-Timer (rationale-watcher.timer), jede Minute: Erfassungen, Übergaben, Zusammenfassungen und Updates. Ohne systemd-User-Session sagt init das, und die Hooks erfassen trotzdem jeden Turn.

rationale status zeigt jederzeit die Anmeldungen, den Workspace dieses Repositorys, die Hooks, den Watcher und die letzte Sitzung.

Was passiert, während Sie arbeiten

• Erfassung. Wenn eine Sitzung endet (der Stop-Hook von Claude Code oder der Watcher bei Codex), baut der Client ein kompaktes Delta der neuen Turns, ohne Tool-Ausgaben und ohne Thinking, und bittet Ihren Agenten, die Entscheidungen herauszusuchen: Frage, Wahl, Kriterien, was verworfen wurde, wann sie zu überdenken ist, die Dateien und die Aufgabe, um die es geht, und die eigenen Worte der Person, die eine frühere Entscheidung bestätigen, korrigieren oder zurückziehen. Eine fehlgeschlagene Extraktion wird später wiederholt und blockiert den Agenten nie.
• Warnungen vor der Änderung. Wenn der Agent eine Datei liest oder gleich ändern wird, an der eine Entscheidung verankert ist, fragt der Hook bei Rationale innerhalb eines Budgets von zwei Sekunden nach diesen Entscheidungen und zeigt sie dem Agenten vor der Änderung: wer entschieden hat, die Kurzfassung und wie viele Commits die Datei seitdem berührt haben. Ist der Server langsam, bekommt der Agent die Kurzfassung stattdessen aus einem lokalen Index. Eine Entscheidung, die eine Klasse, eine Tabelle oder einen Ticket-Key nennt, wird auf Ihrem Rechner im Inhalt der Datei gesucht; dieser Inhalt verlässt ihn nie.
• Kontext für eine Aufgabe. Tippen Sie den #handle einer Aufgabe in einen Prompt, und der Agent startet mit dem, was dazu entschieden wurde, wer daran arbeitet und welche Pull Requests offen sind.
• Notizen beim Sitzungsstart. Ihre Notizen zum Repository, zum Workspace und zum Projekt erreichen den Agenten, wenn eine Sitzung startet.
• Übergaben. Eine Sitzung mit Entscheidungen, die 30 Minuten lang still bleibt, bekommt eine Übergabe für die Person, die die Aufgabe übernimmt: Zusammenfassung, nächste Schritte, offene Fragen.
• Nie im Weg. Ein Hook, der fehlschlägt, beendet sich still und lässt den Agenten weiterarbeiten. Nichts wartet auf das Netzwerk außer der Warnung, und die hat ihr Budget.

Befehle

Claude, ChatGPT, Cursor und andere Assistenten verbinden (MCP)

Assistenten, die das Model Context Protocol sprechen, lesen die Entscheidungen Ihres Teams und halten neue fest, über den Remote-Server unter https://mcp.rationalehq.com/mcp. Er nutzt OAuth 2.1: URL einfügen, einmal im Browser anmelden und Ihre Workspaces freigeben. Jedes Tool sagt, ob es liest oder schreibt: context_for, list_tasks, record_decision, record_handoff, record_note, pull_request_for und einige weitere.

• Claude Code: claude mcp add --scope user --transport http rationale https://mcp.rationalehq.com/mcp, dann die Browser-Anmeldung, die Claude Code öffnet.
• Codex: codex mcp add rationale --url https://mcp.rationalehq.com/mcp, dann codex mcp login rationale.
• Claude (claude.ai und die Desktop-App): Settings → Connectors → Add custom connector, mit der URL oben. Melden Sie sich an, wenn Claude danach fragt.
• ChatGPT: Settings → Connectors → Create, mit der URL oben (benutzerdefinierte Connectors brauchen einen Tarif, der sie zulässt). Melden Sie sich an, wenn ChatGPT danach fragt.
• Cursor und andere MCP-Clients: Fügen Sie in den MCP-Einstellungen des Clients einen Server mit dieser URL hinzu (bei Cursor ~/.cursor/mcp.json) und melden Sie sich an, wenn Sie dazu aufgefordert werden.

Ein Projekt kann seinen Workspace mit ?workspace=slug an der URL festlegen. Die Seite Get started in der App zeigt dieselben Befehle, ausgefüllt mit Ihren Angaben.

GitHub und Jira verbinden

In der App unter Settings → Connectors. GitHub wird als GitHub App in den Organisationen installiert, die Sie auswählen; Jira verbindet sich per OAuth mit Ihrer Atlassian-Site. Beides gilt pro Mitglied: Jede Person sieht in Rationale nur die Repositories, Pull Requests, Tickets und Projekte, die ihr eigenes Konto sehen kann.

Pull Requests, Reviews und Issues werden mit den Entscheidungen verknüpft, die für die von ihnen geänderten Dateien gelten. Jira-Tickets und Epics werden zu Aufgaben, und Entscheidungen folgen dem Ticket. Ohne Tracker leben die Aufgaben in Rationale, und Agenten öffnen sie, wenn Sie darum bitten.

Was Ihren Rechner verlässt, und was ihn nie verlässt

Extraktion, Übergaben und Zusammenfassungen laufen mit Ihrem eigenen Agenten über Ihren eigenen Tarif, sodass die Kosten auf Ihrer Seite bleiben und sichtbar sind: Jede Erfassung trägt ihren Kostengegenwert. Das Ergebnis eines Updates (ok, ungültige Signatur, zurückgerollt) meldet der Client als Code mit seiner nächsten Anfrage, nie als Log.

Updates, Rollback, Deinstallation

Der Watcher, nie ein Hook, prüft das signierte Release-Manifest höchstens alle sechs Stunden und tauscht die Binärdatei an Ort und Stelle aus; die vorherige bleibt erhalten. Zwei öffentliche minisign-Schlüssel sind in jede Binärdatei einkompiliert: ein Release-Schlüssel, der jedes Manifest signiert, und ein Offline-Backup-Schlüssel, der nur zum Rotieren des ersten dient. Ein Manifest, das keiner der beiden Schlüssel signiert hat, wird abgelehnt; ebenso ein erneut eingespieltes (Replay). Homebrew-Installationen melden nur, dass eine neuere Version existiert.

rationale update
rationale update --rollback

Zum Verlassen: rationale uninstall entfernt die Hooks und den Watcher; danach widerrufen Sie das Gerät auf der Devices-Seite der App, was sein Token ungültig macht. Die Konfiguration bleibt in ~/.config/rationale/ und der Zustand in ~/.local/state/rationale/, bis Sie sie löschen.

Wenn etwas nicht stimmt

• rationale: command not found: ~/.local/bin ist nicht in Ihrem PATH; der Installer hat die Zeile ausgegeben, die Sie Ihrem Shell-Profil hinzufügen müssen.
• Sitzungen werden nicht erfasst: Führen Sie rationale status aus. Das Remote des Repositorys muss von genau einem Projekt in einem Ihrer Workspaces aufgelistet sein; beanspruchen es zwei Workspaces, stoppt die Erfassung, bis einer es aufgibt. Codex-Hooks erfassen erst, wenn Sie ihnen vertraut haben.
• Warnungen erscheinen nicht: Der Hook hat ein Budget von zwei Sekunden und gibt bei langsamem Netzwerk still auf; der nächste versucht es erneut. rationale anchors check PATH zeigt, was ein Hook zu einer Datei sagen würde.
• Unternehmens-Proxy: Der Client nutzt den Zertifikatsspeicher Ihrer Plattform, sodass ein Proxy mit eigenem Root-Zertifikat ohne Konfiguration funktioniert.
• Alles andere: support@rationalehq.com, mit der Ausgabe von rationale status. Sie enthält kein Transkript und keinen Entscheidungstext.