Enfin disponible ! Ralph TUI, visualisation de Ralph Loop

# Enfin disponible ! Ralph TUI, visualisation de Ralph Loop J'ai écrit un tutoriel sur **ralph-loop** auparavant, et de nombreux amis qui l'ont suivi ont donné des commentaires cohérents : **C'est génial, Claude Code peut enfin fonctionner pendant longtemps.** Mais parfois, vous l'observez et il semble immobile, et vous ne pouvez pas vous empêcher de vous demander : "Est-ce qu'il avance ou est-ce qu'il tourne en rond ?" C'est la raison pour laquelle j'ai récemment bricolé **ralph-tui**.  **ralph-tui ne force pas la liaison avec Claude Code, il hérite et développe l'essence de ralph loop, et visualise l'exécution des tâches et le processus, ce qui réduit considérablement le seuil pour faire travailler de grands modèles pendant longtemps.** Vous pouvez tout à fait connecter d'autres agents, d'autres modèles, des modèles nationaux, bon marché, ceux que vous pouvez vous permettre de faire fonctionner à long terme. Avec ralph-tui, pour nous, les gens ordinaires, cela revient à passer d'une boîte de vitesses manuelle à une boîte de vitesses automatique avec régulateur de vitesse. ## Qu'est-ce que c'est exactement ? Vous pouvez considérer ralph-tui comme un "**orchestrateur de boucle d'agent de codage IA**", mais il ne se contente pas de "pouvoir fonctionner", il se soucie davantage de "**vous pouvez voir, vous pouvez contrôler, vous pouvez restaurer**". Son mode de fonctionnement de base est très simple : - Vous lui donnez un tas de tâches (provenant d'un PRD ou d'un autre système de tâches) - Il choisit celle qui a la priorité la plus élevée - Il assemble le prompt - Il lance l'agent pour qu'il exécute - Il détermine si la tâche est considérée comme terminée - Il écrit l'état - Il continue au tour suivant L'important est que : vous pouvez tout voir dans le terminal, et vous pouvez vous arrêter et reprendre à tout moment. Il a également écrit son positionnement de manière très directe : un orchestrateur de boucle d'agent avec TUI interactif, et prend en charge TUI / headless / remote. ## Pourquoi dis-je qu'il est plus adapté à un "fonctionnement à long terme" ? Le plus gros problème avec l'exécution de scripts en boucle n'est pas qu'ils ne peuvent pas fonctionner, mais que vous ne savez pas où ils en sont. Vous voyez les logs défiler rapidement, et le ventilateur tourne joyeusement, mais vous n'êtes pas sûr : - Est-ce qu'il corrige le même bug à plusieurs reprises ? - Est-ce qu'il modifie sans cesse le même code pour ensuite le modifier à nouveau ? - Est-ce qu'il a déjà terminé, mais n'a pas quitté ? - Est-ce qu'il est bloqué dans une boucle infinie sur un test ?  La solution de ralph-tui est très "ingénierie" : - Il y a un concept de session, l'état est enregistré sur le disque (.ralph-tui/session.json) - Il peut reprendre l'exécution en cas de crash (crash recovery) - Il y a un mécanisme de verrouillage pour éviter que vous n'ouvriez plusieurs instances et que vous ne transformiez le répertoire en bouillie - Il peut même être exécuté en mode headless dans CI, et même ouvrir un listener à distance et connecter le TUI local En un mot : **Il ressemble plus à "vous gérez un ouvrier qui sait écrire du code" qu'à "vous surveillez un script qui a des ratés".** ## Comment installer ralph-tui est un écosystème Bun/TypeScript, donc l'installation est assez simple. Le site officiel fournit également une page d'installation. Vérifiez d'abord que vous avez bun sur votre machine : `bun --version` puis installez ralph-tui (je donne ici une installation typique, référez-vous à la page d'installation officielle pour plus de détails) : `bun add -g ralph-tui` Une fois l'installation terminée, vérifiez : `ralph-tui --help` Si vous êtes un adepte de Node et que vous ne voulez pas toucher à bun, c'est possible : `npm i -g ralph-tui` ## Ne vous lancez pas tout de suite dans de grands projets, exécutez une boucle fermée minimale Je vous suggère, pour la première fois, de ne pas vous lancer dans un "remodelage de tout le repo". Faites une seule chose : **Faites en sorte qu'il exécute une petite tâche acceptable.** ### Initialisation Ouvrez un répertoire quelconque : `mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup` Cela lancera un processus de guidage interactif, qui consiste essentiellement à "installer ralph-tui dans votre dépôt", il va : - Détecte automatiquement les agents installés sur votre machine (par exemple, Claude Code, OpenCode, etc.) - Génère un fichier de configuration dans le projet : .ralph-tui/config.toml - Installe facilement les skills liés à la génération de PRD/conversion de tâches (vous n'aurez plus à vous embêter à le faire manuellement par la suite) Je vous conseille personnellement : ne soyez pas paresseux la première fois, **lancez impérativement la commande setup**. ### Générer un PRD de projet Une fois la commande setup exécutée, l'étape suivante est le cœur du tutoriel officiel, et aussi ce qui est le plus approprié pour écrire un article de blog : **create-prd**. La commande `ralph-tui create-prd --chat` lance un processus de conversation, qui vous interrogera comme un chef de produit sur les objectifs, les limites et les critères d'acceptation de vos besoins. Une fois terminé, elle générera directement deux éléments dans le projet (c'est le point essentiel) : - Un fichier markdown de PRD : ./tasks/prd-feature.md - Un fichier de tâches directement exécutable : ./prd.json À ce stade, vous entrez véritablement dans la "boucle standard" de ralph-tui : **Besoin (PRD) → Tâche (prd.json) → Exécution (run)** ### Lancer l'exécution (run) Une fois que vous avez prd.json, l'exécution devient naturelle : `ralph-tui run --prd ./prd.json` Vous verrez l'interface TUI se lancer et commencer une boucle : choisir une tâche → exécuter → déterminer si elle est terminée → écrire l'état → terminer ou passer au tour suivant. La première fois, je vous recommande vivement d'ajouter une limite d'itérations, pour la mettre en cage au début : `ralph-tui run --prd ./prd.json --iterations 5` Une fois l'exécution terminée, examinez les modifications, exécutez les tests, vérifiez si le PRD et les tâches correspondent aux attentes. Une fois que vous avez confirmé que cette chaîne fonctionne, vous pouvez relâcher les itérations, passer en mode headless/remote, c'est le rythme à adopter. À ce moment-là, vous pouvez essentiellement confirmer : **cette boucle fonctionne réellement.** ## Comment choisir le modèle/Agent ? Parlons franchement de l'économie Je sais que beaucoup de gens se soucient le plus de : "Puis-je éviter d'utiliser Claude Code ? Puis-je utiliser des modèles moins chers ?" La réponse est : **Oui.** ralph-tui lui-même vous permet de spécifier l'agent et le modèle (il y a des exemples dans la documentation officielle de run). Par exemple, en utilisant Claude Opus : `ralph-tui run --prd ./prd.json --agent claude --model opus` Mais honnêtement, je n'utiliserais pas Opus pour des tâches comme "compléter les tests, corriger les erreurs de lint", c'est trop cher. Ma pratique est de diviser les tâches en couches : - **Modèles bon marché** : pour exécuter de nombreuses tâches répétitives (compléter les tests, compléter les commentaires, corriger le format, ajouter des limites) - **Modèles chers** : uniquement pour les étapes clés (ajustement de l'architecture, bugs difficiles, logique centrale) Si vous êtes un développeur ordinaire, cette approche est encore plus importante. Parce que vous n'avez pas le budget d'une grande entreprise, vous devez rendre les coûts contrôlables pour pouvoir continuer à long terme. ## Vous voulez que ce soit encore plus agréable ? Confiez également la "rédaction du PRD" à l'agent ralph-tui a une conception que j'aime beaucoup : il prend en charge les skills (en gros, c'est un ensemble de commandes externes pour l'agent). La méthode d'installation officielle consiste à utiliser add-skill : `bunx add-skill subsy/ralph-tui --all` Ou à l'installer sur un agent spécifique, par exemple claude-code : `bunx add-skill subsy/ralph-tui -a claude-code -g -y` Une fois installé, vous pouvez utiliser une commande slash dans la session de l'agent : `/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads` C'est comme si vous aviez installé un plugin dans votre IDE, sauf que ce plugin est destiné à l'agent. Son intérêt est de réduire le temps de "transfert manuel des besoins", afin que le besoin → tâche → exécution ressemble davantage à une chaîne de montage. ## Quand faut-il l'utiliser ? Quand ne faut-il pas l'utiliser ?Je n'aime pas trop le discours du genre "l'IA peut tout faire", c'est facile d'induire les gens en erreur. Un outil est un outil, il n'a de valeur que s'il est adapté à la situation. ### Scénarios où ralph-tui est adapté Vous avez une pile de tâches comme celles-ci : - Compléter les tests (surtout les anciens projets) - Corriger les erreurs de lint / format - Refactorisation par petits pas (rassembler le code dupliqué) - Ajouter des types en masse, compléter les limites - Découper les exigences et les faire avancer lentement selon une file d'attente de tâches Ces tâches ont un point commun : **beaucoup de tâches, haut degré de répétition, peuvent être acceptées, peuvent être itérées et progresser.** ### Scénarios où il ne faut pas forcer ralph-tui Vous devez faire ce genre de choses : - Refactorisation majeure unique, critères d'acceptation flous - Les exigences elles-mêmes sont vagues, reposant sur vos connaissances implicites - Nécessite beaucoup de communication/confirmation inter-équipes - Nécessite que vous preniez des décisions concernant le produit Pour ce genre de tâches, la boucle d'agent ne fera qu'amplifier le chaos. ## Quelle est la différence entre ralph-loop (ralph-claude-code) et lui ? **ralph-claude-code** ressemble plus à un "plugin de conduite autonome pour Claude Code" : le script le lance, exécute la boucle, la détection de sortie, la limitation de débit et le disjoncteur sont là pour vous protéger. Vous voulez de la "rapidité", il est très rapide. **ralph-tui** ressemble plus à une "console de contrôle d'ingénierie pour la boucle d'agent" : il ne soude pas un certain modèle, ni un certain système de tâches. Il veut résoudre les problèmes d'ingénierie tels que "exécution à long terme, observable, contrôlable, récupérable, à distance". Alors, vous me demandez comment choisir ? - Vous êtes un utilisateur de Claude Code et vous voulez le faire fonctionner rapidement → ralph-claude-code - Vous voulez connecter différents modèles, économiser de l'argent, gérer la boucle comme un service → ralph-tui ## Enfin : ne laissez pas votre dépôt devenir un laboratoire J'ai moi-même quelques règles d'or pour exécuter la boucle d'agent, écrivez-les ici et suivez-les, la probabilité de se planter sera beaucoup plus faible : - **Exécutez-le sur une branche, ne jouez pas avec le feu sur la branche main.** - **La première fois que vous l'exécutez, ajoutez обязательно --iterations, confirmez d'abord par petits pas qu'il ne deviendra pas fou.** - **La tâche doit être acceptable** : soit elle peut exécuter des tests, soit elle peut exécuter lint, soit elle peut comparer les fichiers de sortie. - **Vous devez apprendre à vous arrêter** : voir qu'il commence à tourner en rond, il est plus intelligent de faire une pause que de continuer à brûler de l'argent. - **Les modèles bon marché font le sale boulot, les modèles chers font le travail essentiel** : le coût est géré, il n'est pas prié.Adresse du projet : https://github.com/subsy/ralph-tui