Des sessions ancrées dans les fichiers, pas dans la mémoire du chat.
repo-harness transforme les sessions de code de Claude et Codex en un flux reproductible, local au dépôt. Confiez à l'agent un plan ou un sprint approuvé — votre boucle se résume à review et next.
Le chat oublie. Le dépôt se souvient.
Le même problème de coordination, de deux façons. repo-harness sort la source de vérité du fil de discussion pour la placer dans des fichiers que chaque agent — et chaque humain — peut lire.
- Le contexte se volatilise quand une session se termine ou atteint sa limite
- Chaque session redécouvre la structure par des boucles grep-et-lecture
- Aucune trace durable de ce qui a été décidé, ni pourquoi
- Claude et Codex se désynchronisent au fil des conversations
- Réviser, c’est relire toute la conversation
- Reprenez à la prochaine étape exacte depuis .ai/harness/handoff/
- Un contexte racine stable d’environ 12 Ko, plus un index CodeGraph
- Plans, contrats, vérifications et revues vivent dans le dépôt
- Claude et Codex lisent d’abord les mêmes artefacts sources
- Révisez à partir d’une seule Human Review Card et de preuves machine
La surface est volontairement réduite.
Inspectez un dépôt, installez les fichiers de flux locaux au dépôt, routez les événements de l'hôte par des hooks, et gardez les surfaces de flux cohérentes entre Claude, Codex et les humains.
Sessions ancrées dans les fichiers
Transferts, plans et paquets de reprise vivent dans le dépôt. Une session peut s'arrêter en cours de tâche ; la suivante reprend à l'étape exacte, aux blocages et aux fichiers modifiés.
Sobre en tokens par conception
Un contexte racine stable d'environ 12 Ko plus un index CodeGraph pour les requêtes structurelles — au lieu de boucles grep-et-lecture qui rescannent le dépôt à chaque session.
Des hooks qui protègent et tracent
Huit routes gérées avertissent, bloquent, tracent et transfèrent le travail. Les barrières d'édition tiennent jusqu'à l'approbation du plan ; les barrières de « fait » vérifient des preuves ancrées dans les fichiers.
Une seule Human Review Card
Une surface de décision sur un écran par tâche : verdict, fichiers prévus vs réels, commandes passées, risque résiduel et rollback.
Worktrees isolés
Les agents travaillent dans une branche ou un worktree liés, limités aux chemins autorisés par le contrat — l'état modifié sans rapport reste protégé.
Local et auditable
La vérité durable, ce sont les fichiers du dépôt, pas l'historique de chat ni des fils hébergés. Le sidecar MCP optionnel n'expose que les artefacts de flux — aucune écriture de source, aucun shell.
Local, auditable, natif pour agents.
Huit couches, une source de vérité. La CLI orchestre ; les contrats et le système de classement tiennent l'état durable ; la couche de vérification prouve le travail — et ChatGPT Pro planifie en local pendant que Claude ou Codex exécute.
Une chaîne en couches, de bout en bout.
La chaîne de planification est volontairement étagée. Chaque étape écrit un artefact prêt à décider que l'agent suivant lit en premier — le chat n'est jamais la source de vérité.
Cartographier le terrain : fichiers, surfaces et l'existant que le changement touche.
Tracer l'impact : appelants, appelés et la chaîne de causes derrière.
Décision et justification : l'approche choisie, et pourquoi — consignée pour l'agent suivant.
Un cadrage guidé, puis un PRD de couche supérieure sous plans/prds/.
Le PRD devient un sprint avec des lignes d’acceptation vérifiables par la machine.
Un prompt /goal borné fait passer chaque tranche de sprint dans la boucle, sur l'un ou l'autre agent.
N'acceptez que lorsque la revue recommande le succès, que le verdict de la carte est succès et que l'acceptation externe passe. Inspectez ensuite le contrat, la dernière trace et les fichiers modifiés.
Planifiez avec ChatGPT Pro. Exécutez avec Claude ou Codex.
Le sidecar optionnel repo-harness mcp n'expose que des artefacts de flux aux clients MCP. ChatGPT Pro planifie sur l'état réel du dépôt et fait avancer une idée à travers PRD → Sprint → transfert Goal — ensuite votre session Claude ou Codex existante exécute le sprint ancré dans les fichiers.
- 1 Lire l'état du dépôt
ChatGPT lit les fichiers de flux via le sidecar MCP — plans, contrats, vérifications, transferts.
- 2 Écrire le PRD
write_prd_from_idea rédige un PRD prêt à décider sous plans/prds/.
- 3 Écrire le Sprint
write_checklist_sprint le transforme en backlog ordonné à acceptation vérifiable par la machine.
- 4 Préparer le transfert
prepare_codex_goal_from_sprint écrit .ai/harness/handoff/codex-goal.md.
- 5 Claude ou Codex exécute
Votre session Claude ou Codex existante lance le prompt /goal natif de l’hôte et met en scène chaque phase de sprint terminée.
Huit routes de hook gérées.
L'adaptateur installé possède huit routes. Le tuple event + routeId + matcher est le contrat stable — elles avertissent, bloquent, tracent et transfèrent le travail entre sessions.
les routes de protection échouent en mode fermé — les barrières requises bloquent quand leurs scripts manquent.
Acceptez ou rejetez depuis un seul écran.
Chaque tâche écrit une Human Review Card — la surface de décision sur un écran. Voyez ce qui a changé, pourquoi c'était dans le périmètre, ce qui l'a vérifié, le risque restant et comment revenir en arrière.
N'acceptez que lorsque la revue recommande le succès, que le verdict de la carte est succès et que l'acceptation externe est succès, not_required ou une dérogation manuelle explicite.
Propulsé par Bun. Une commande pour démarrer.
L'installeur par défaut tourne sur Bun — aucune config Node requise, et il installe Bun pour vous s'il manque. Déjà sur Node ? Ça marche aussi. Démarrez le runtime une fois, puis prévisualisez le contrat local au dépôt avec un dry run avant toute application.
repo-harness adopt --dry-run depuis la racine du dépôt. Il signale chaque fichier qui serait créé ou rafraîchi — n’appliquez que si le rapport semble correct.Bâti sur le bon travail des autres.
Ces skills, dépôts et runtimes ont façonné le contrat de flux pendant la conception et la sortie de repo-harness. Ils sont remerciés ici comme influences — pas comme des dépendances ordinaires.
La méthode de due diligence P1/P2/P3 et la pratique Geju derrière la discipline de planification, de traçage et de justification des décisions.
Les skills think, hunt, check et health pour la planification quotidienne, les chasses aux bugs, la vérification et la synchro de skills Codex-first.
Découverte produit, revue de plan et de design, hygiène documentaire post-livraison, synchro de connaissances et mémoire de dépôt au long cours.
Diagrammes d'architecture et de flux système lisibles.
Navigation par symboles, traçage d'impact et contrôles de disponibilité.
Agent d'exécution principal pour l'implémentation et la vérification locales au dépôt.
Quand Codex contribue de façon substantielle à un commit, celui-ci porte Co-authored-by: codex <codex@openai.com> — opt-in et visible par commit.
Rendez votre prochaine session agent reprenable.
Démarrez le runtime, prévisualisez le contrat avec un dry run, puis prouvez le flux. Gratuit et open source sous licence MIT.