Enfin disponible ! Ralph TUI, visualisation de Ralph Loop

# Enfin disponible ! Ralph TUI, visualisation de Ralph Loop J'avais écrit un tutoriel sur **ralph-loop**, et de nombreux amis qui l'ont suivi ont eu des retours assez similaires : **C'est génial, Claude Code peut enfin fonctionner longtemps.** Mais parfois, vous l'observez et il semble immobile, et vous vous demandez : "Est-ce qu'il avance vraiment, ou est-ce qu'il tourne en rond ?" C'est la raison pour laquelle je me suis récemment penché sur **ralph-tui**.  **ralph-tui ne force pas l'utilisation de 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 la barrière à l'entrée pour faire travailler de grands modèles pendant de longues périodes.** Vous pouvez tout à fait connecter d'autres agents, d'autres modèles, des modèles locaux, bon marché, ceux que vous pouvez vous permettre de faire fonctionner à long terme. Avec ralph-tui, pour nous, les gens ordinaires, c'est comme passer d'une transmission manuelle à une transmission automatique avec régulateur de vitesse. ## Qu'est-ce que c'est exactement ? Vous pouvez considérer ralph-tui comme un "**orchestrateur de boucles pour 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 ensemble 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 l'exécuter - Il détermine si la tâche est considérée comme terminée - Il écrit l'état - Il passe à la prochaine tâche L'important est que vous pouvez tout voir dans le terminal, et vous pouvez arrêter et reprendre à tout moment. La description officielle est également très claire : un orchestrateur de boucle d'agent avec une interface TUI interactive, et qui 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 boucles de scripts n'est pas qu'ils ne peuvent pas fonctionner, mais que vous ne savez pas où ils en sont. Vous voyez les journaux défiler rapidement, et le ventilateur tourne joyeusement, mais vous n'êtes pas sûr : - Est-ce qu'il corrige le même bug en boucle ? - Est-ce qu'il modifie sans cesse le même code pour ensuite le remettre comme avant ? - 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 une notion de session, l'état est enregistré sur le disque (.ralph-tui/session.json) - Il peut reprendre après un 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 un CI, ou même ouvrir un listener à distance et connecter le TUI local En un mot : **c'est plus comme si "vous gériez un ouvrier qui sait écrire du code", plutôt que "vous surveillez un script qui part en vrille".** ## Comment installer ralph-tui est basé sur l'écosystème Bun/TypeScript, donc l'installation est assez simple. La page d'installation officielle est également disponible. Vérifiez d'abord que vous avez bun sur votre machine : `bun --version` Puis installez ralph-tui (voici une méthode d'installation typique, référez-vous à la page d'installation officielle pour plus de détails) : `bun add -g ralph-tui` Vérifiez l'installation : `ralph-tui --help` Si vous êtes un adepte de Node et que vous ne voulez pas utiliser bun, c'est possible aussi : `npm i -g ralph-tui` ## Ne vous lancez pas tout de suite dans de grands projets, exécutez une boucle minimale Je vous conseille, pour la première utilisation, de ne pas vous lancer dans la "refactorisation de tout le repo". Faites juste une 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 assistant 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 les skills liés à la génération de PRD/conversion de tâches (vous n'aurez plus à vous en soucier manuellement par la suite) Mon conseil personnel : ne soyez pas paresseux la première fois, **exécutez setup absolument**. ### Générer un PRD de projet Une fois setup terminé, l'étape suivante est le cœur du tutoriel officiel, et aussi ce qui convient le mieux pour un article de blog démo : **create-prd**. La commande `ralph-tui create-prd --chat` lancera un processus de dialogue, qui vous interrogera sur les objectifs des exigences, les conditions limites et les critères d'acceptation, comme un chef de produit. Une fois terminé, il générera directement deux éléments dans le projet (c'est le point essentiel) : - Un fichier markdown PRD : ./tasks/prd-feature.md - Un fichier de tâches exécutable directement : ./prd.json À ce stade, vous entrez réellement dans la "boucle standard" de ralph-tui : **Besoin (PRD) → Tâche (prd.json) → Exécution (run)** ### Lancer l'exécution (run) Avec prd.json, l'exécution (run) devient une évidence : `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 recommande fortement d'ajouter une limite d'itération, pour la mettre en cage : `ralph-tui run --prd ./prd.json --iterations 5` Une fois terminé, vous pouvez examiner les modifications, exécuter des tests, et vérifier si le PRD et les tâches correspondent aux attentes. Une fois que vous avez confirmé que cette chaîne est fonctionnelle, vous pouvez relâcher les itérations, passer en mode headless/remote, c'est le rythme fiable. À ce stade, vous pouvez essentiellement confirmer : **cette boucle fonctionne vraiment.** ## Comment choisir le modèle/l'Agent ? L'économie d'argent doit être honnête Je sais que beaucoup de gens se soucient le plus de : "Puis-je ne pas 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 faire des choses comme "compléter les tests, corriger les erreurs de lint", c'est trop cher. Ma pratique est de diviser en couches : - **Modèles bon marché** : exécuter beaucoup de travail répétitif (compléter les tests, compléter les commentaires, corriger le format, ajouter des limites) - **Modèles chers** : n'apparaissent qu'aux points clés (ajustement de l'architecture, bugs difficiles, logique centrale) Si vous êtes un développeur ordinaire, cette façon de penser 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 fonctionner longtemps. ## Vous voulez encore plus de plaisir ? 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 est d'utiliser add-skill : `bunx add-skill subsy/ralph-tui --all` Ou installez-le sur un agent spécifique, tel que claude-code : `bunx add-skill subsy/ralph-tui -a claude-code -g -y` Une fois installé, vous pouvez utiliser la commande slash dans la conversation de l'agent : `/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads` C'est comme si vous aviez installé un plugin dans l'IDE, sauf que ce plugin est destiné à l'agent. Son intérêt est de réduire le temps de "transfert manuel des exigences", de sorte que les exigences → tâches → exécution ressemblent davantage à une chaîne de montage. ## Quand devriez-vous l'utiliser ? Quand ne devriez-vous 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é à un scénario précis. ### Scénarios où ralph-tui est adapté Vous avez une pile de tâches comme celles-ci : - Compléter les tests (surtout pour les anciens projets) - Corriger les erreurs de lint / formater - 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 l'utilisation de ralph-tui Vous devez faire ce genre de choses : - Refactorisation majeure unique, critères d'acceptation flous - Les exigences elles-mêmes sont vagues, basées sur vos connaissances implicites - Nécessite beaucoup de communication/confirmation inter-équipes - Nécessite que vous preniez des décisions concernant le produit Dans ce genre de tâches, la boucle d'agent ne fera qu'amplifier le chaos. ## Quelle est la différence avec ralph-loop (ralph-claude-code) ? **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é", et il est très rapide. **ralph-tui** ressemble plus à une "console de contrôle d'ingénierie pour une boucle d'agent" : il ne soude pas un modèle spécifique, ni un système de tâches spécifique. Il cherche à 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 une boucle d'agent, écrivez-les ici et suivez-les, la probabilité de catastrophe sera beaucoup plus faible : - **Exécutez sur une branche, ne jouez pas avec le main.** - **La première fois que vous exécutez, ajoutez toujours --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 un linter, 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 gros du travail, 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