Comment Rationale fonctionne, et ce qui quitte votre machine

1 · Capturer : quand un tour se termine

Installez le client une fois par ordinateur. Dès lors, chaque fois que votre agent termine un tour, il exécute le hook Stop du client (Claude Code ; Codex une fois que vous avez fait confiance aux hooks). Le hook lance une capture en arrière-plan et rend la main aussitôt, si bien que l'agent n'attend jamais. Un watcher fait de même chaque minute pour tout tour qu'un hook aurait manqué : un plantage, une fenêtre fermée, une session inactive depuis une minute avec de nouveaux tours.

La capture lit la transcription de la session sur votre machine et construit un delta compact des nouveaux tours : vos messages, les réponses de l'agent et les outils qu'il a appelés, avec leur entrée coupée à 200 caractères. La sortie des outils, le raisonnement et le texte que l'agent injecte de lui-même restent dehors. Jusqu'à 120 tours tiennent dans un bloc, avec jusqu'à 30 tours antérieurs en contexte de lecture seule, pour qu'un bloc court ne soit pas lu isolément.

Le delta va à la CLI de l'agent sur votre machine, connectée avec votre compte : claude -p pour une session Claude Code, codex exec pour une session Codex. Une session Codex ne va jamais chez Anthropic, et une session Claude Code ne va jamais chez OpenAI. Pour Claude Code l'appel est minimal : un system prompt, un schéma JSON, aucun outil, aucun réglage, aucun hook, aucun serveur MCP, aucun fichier de session, de sorte qu'il n'apparaît jamais dans votre historique. Pour Codex, c'est le codex exec documenté, éphémère, en lecture seule, dans un dossier vide, avec les hooks du client désactivés.

Seules les sessions dans un dépôt listé par l'un de vos projets sont capturées. Le client demande à Rationale lequel de vos espaces de travail liste le remote git du dépôt et garde la réponse dix minutes. Aucun projet : rien n'est extrait ni envoyé. Deux espaces de travail : rien non plus, et rationale status les nomme tous les deux. Une extraction qui échoue est retentée après 5, puis 15, puis 60 minutes tant que le même bloc échoue, et ne bloque jamais l'agent.

Ce qui parvient à Rationale est le résultat : les décisions, plus l'identifiant et le titre de la session, les numéros de tour, le dépôt, la branche, le commit, l'heure du dernier tour, l'agent, le modèle, la durée, les tokens et le coût équivalent. Le point d'entrée qui reçoit une capture n'a aucun champ qui pourrait porter une transcription.

2 · Enregistrer : ce que contient une décision

Une décision n'est pas un résumé de la session. Elle a une question, le choix, les critères qui l'ont guidé avec leur poids, les options écartées et pourquoi, des hypothèses, et ce qui amènerait l'équipe à la réexaminer. Elle est ancrée à des chemins du dépôt et à des identifiants (une classe, une table, une clé de ticket), et dit de quoi elle relève : business, produit ou technique. Les propres mots de la personne qui l'a décidée sont cités.

Toute décision est enregistrée comme inférée : un agent l'a extraite. Elle ne devient confirmée que par une personne : un clic dans l'application, ses propres mots dans une session (le client vérifie la citation dans la transcription avant de l'envoyer, si bien qu'un agent disant que quelqu'un a confirmé ne suffit pas), ou la fusion de la pull request qui la portait. Les deux origines restent visibles, et les agents voient la différence.

Les décisions sont numérotées par espace de travail (D-42), conservées en versions immuables et chiffrées au repos. Le serveur ne lit que des identifiants, des états, des ancrages et des horodatages. Chaque lecture et chaque confirmation est écrite dans le journal d'audit de l'espace de travail. L'extracteur signale aussi quand la personne a confirmé, corrigé ou retiré une décision antérieure dans la conversation, et quand l'agent l'a interrogée sur l'une d'elles.

Une session qui n'a nommé aucune tâche envoie ses décisions dans la boîte de réception du projet, où l'équipe les relie, les garde ou les retire. Une répétition d'une décision déjà enregistrée est reliée, pas enregistrée deux fois.

3 · Donner le contexte : #handle, notes et MCP

Une tâche est un #handle : un slug lisible, unique dans l'espace de travail, auquel tout se rattache : sessions, décisions, passations, pull requests, tickets. Tapez-le dans n'importe quel prompt et le hook UserPromptSubmit envoie à Rationale le handle, le dépôt et la branche, rien d'autre du prompt. En retour vient le contexte de la tâche : son état, ses décisions actives par domaine, ses dernières passations et ses pull requests ouvertes. La session est reliée à la tâche, si bien que ses captures suivantes y atterrissent.

Une branche nommée d'après le handle relie aussi la session, sans rien taper. Quand une session démarre, le hook SessionStart récupère vos notes : des consignes permanentes que vous avez données à vos agents (« réponds-moi en espagnol », « ne touche jamais aux contrôleurs v1 ») pour l'espace de travail et le projet de ce dépôt, en moins de 300 tokens et deux secondes. Pour cela, seul le remote du dépôt quitte votre machine.

Les assistants qui n'ont pas de hooks se connectent par MCP : Claude (claude.ai et l'application de bureau), ChatGPT, Cursor, Claude Code et Codex eux-mêmes, et tout client qui parle le protocole. Le serveur distant à https://mcp.rationalehq.com/mcp utilise OAuth 2.1 avec PKCE : collez l'URL, connectez-vous une fois, autorisez vos espaces de travail. Il n'y a pas de clés d'API. Ses outils sont 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 et suggest_same_person ; chacun déclare s'il lit ou écrit, pour que votre client puisse vous demander avant une écriture.

Les décisions business viennent en premier, présentées comme des contraintes que les choix produit et techniques n'annulent pas. Tout ce qu'un agent enregistre par MCP est inféré, avec les mots de la personne cités, parce que rien ne peut vérifier une conversation que Rationale n'a pas vue.

4 · Alerter : avant la modification, pas en revue

Le hook PostToolUse s'exécute après chaque appel d'outil et se termine en quelques millisecondes pour les outils qu'il ne surveille pas. Il surveille Read, Edit, Write, MultiEdit et NotebookEdit, et les commandes Bash qui nomment un fichier, parce que les agents lisent avec cat, sed et grep aussi souvent qu'avec Read ; pour Codex, les commandes shell et apply_patch. La lecture est le moment qui compte : le modèle doit encore écrire sa modification.

Le hook garde un index des décisions ancrées du dépôt, rafraîchi en arrière-plan au démarrage de la session et après chaque tour : pour chaque décision son numéro, ses chemins, ses identifiants, son domaine, son commit et l'essentiel (question et choix). Il compare le chemin du fichier à cet index sur votre machine et, pour les décisions qui nomment une classe, une table ou une clé de ticket, lit le fichier ici (texte, 512 Ko au plus) pour les y chercher. Le contenu ne sort jamais. Un fichier qui ne correspond à rien ne provoque aucune requête.

En cas de correspondance, une seule requête demande à Rationale le texte de l'alerte : le dépôt, le chemin relatif au dépôt, comment chaque décision a correspondu, quelles décisions l'agent a déjà dans son contexte et, après la modification d'un fichier que la pull request ouverte de quelqu'un d'autre change aussi, les lignes qui viennent de changer. La réponse arrive en moins de deux secondes : au plus trois décisions en entier et les autres par numéro, qui a décidé chacune, si une personne l'a confirmée, et combien de commits ont touché le fichier depuis. Si Rationale est lent ou indisponible, l'agent reçoit l'essentiel depuis l'index local. Chaque alerte montrée est une lecture auditée.

Une fois par fichier et par session ; de nouveau si les décisions changent. Un fichier dont toutes les décisions sont déjà dans le contexte de l'agent ne reçoit pas d'alerte. C'est du contexte, jamais un blocage : le hook ne change jamais les permissions de l'agent et ne l'arrête jamais. Un hook qui échoue se termine silencieusement.

Ce qui quitte votre machine

Une ligne par événement. Chaque ligne a été vérifiée dans le code du client (rationale-client 0.9.0) et dans l'API qui reçoit chaque requête. Là où votre propre CLI s'exécute, la ligne dit ce qui va au fournisseur de votre agent : ce trafic va là où vos sessions vont déjà, avec votre propre compte.

Le contenu des décisions, des notes et des passations est chiffré au repos avec des clés conservées à part de la base de données. Notre équipe voit des identifiants, des états et des ancrages, jamais le contenu, et chaque consultation par notre équipe est écrite dans votre journal d'audit. La page sécurité donne la vue technique ; la politique de confidentialité, la vue juridique.

Installer en deux minutes

Une commande, sans sudo, macOS ou Linux. Elle dépose un binaire dans ~/.local/bin/rationale et rien d'autre : pas encore de hooks, pas de connexion.

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

Ou avec Homebrew :

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

Puis, dans un dépôt que votre espace de travail liste :

rationale init

1. Connectez-vous depuis le navigateur. Le terminal affiche un code et ouvre la page de connexion de l'application. Une connexion par espace de travail ; rationale login en ajoute une autre.
2. Ce dépôt. Il vérifie lequel de vos espaces de travail liste le remote git de ce dépôt. Listé par un seul : capturé. Par aucun : il le dit et demande si vous venez de le lister.
3. Les agents sur cette machine. Il écrit les quatre hooks dans le ~/.claude/settings.json de Claude Code (une sauvegarde est conservée ; vos propres entrées restent intactes) et, si Codex est présent, dans ~/.codex/hooks.json, et vous explique l'étape de confiance que Codex exige. Cursor est détecté et signalé, pas encore capturé.
4. Watcher. Un job launchd sur macOS, un timer utilisateur systemd sur Linux, toutes les minutes : il capture tout tour qu'un hook a manqué, écrit les passations, lance les synthèses et vérifie les mises à jour. Sans session utilisateur systemd, les hooks capturent quand même chaque tour.

C'est fait. Travaillez comme d'habitude. rationale status montre à tout moment les connexions, l'espace de travail de ce dépôt, les hooks, le watcher et la dernière session. Pour lire et enregistrer depuis Claude, ChatGPT ou Cursor, ajoutez le serveur MCP ; la documentation donne les étapes pour chaque client. Pour Claude Code :

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

Les hooks, et comment les retirer

rationale init ajoute quatre entrées à l'objet hooks de ~/.claude/settings.json. Chacune exécute le binaire installé avec le nom de l'événement ; le binaire décide quoi faire, si bien qu'une mise à jour ne réécrit jamais vos réglages. Les délais sont le maximum qu'un hook peut prendre ; ils rendent la main bien avant.

Une entrée ressemble à ceci ; la commande est le chemin absolu du binaire, jamais une recherche dans le PATH :

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

Un hook ne bloque jamais l'agent : toute erreur est absorbée et le hook se termine avec 0 ; un plantage se termine avec un code que Claude Code affiche comme une erreur non bloquante. Les hooks ne font rien dans un dépôt qu'aucun projet ne liste. Pour Codex, les quatre entrées vont dans ~/.codex/hooks.json, sans matcher non plus ; Codex ne les exécute qu'une fois que vous leur avez fait confiance (/hooks dans la CLI, Review hooks dans l'application), et le client n'écrit jamais cette confiance à votre place.

Pour tout retirer :

rationale uninstall

Il retire les quatre hooks de Claude Code et de Codex, en conservant une sauvegarde de chaque fichier de réglages, et retire le watcher. Révoquez ensuite l'appareil sur la page Devices de l'application, ce qui invalide son jeton. La configuration reste dans ~/.config/rationale/ et l'état local dans ~/.local/state/rationale/ jusqu'à ce que vous les supprimiez ; le binaire est un seul fichier que vous pouvez effacer.

Agents et connecteurs aujourd'hui

Ce qui est en production, ce qui est en bêta et ce qui vient ensuite. Nous nommons ce que nous ne couvrons pas plutôt que de le laisser supposer.

Accès anticipé : demandez l'accès et nous configurons votre espace de travail avec vous, sous un jour ouvré.