Introduction à Ralphy

À l'ère des cycles de développement rapides, les développeurs cherchent constamment des moyens de réduire les tâches répétitives de codage. Ralphy propose une solution unique : une interface en ligne de commande autonome (CLI) qui boucle automatiquement à travers une série de moteurs d'IA — Claude Code, Codex, OpenCode, Cursor, Qwen, Factory Droid et GitHub Copilot — pour transformer un document de spécifications produit (PRD) en code réel.

Pourquoi Ralphy se démarque

• Support multi‑moteurs – basculer entre les modèles IA à la volée ou les exécuter en parallèle pour un retour plus rapide.
• Automatisation des tâches – Une seule commande peut lancer une fonctionnalité entièrement fonctionnelle, ou vous pouvez alimenter un PRD complet avec les tâches déjà listées.
• Résolution intelligente des conflits – Lorsque les agents s'exécutent en parallèle, Ralphy fusionne automatiquement les branches et résout la majorité des conflits.
• Automatisation du navigateur – Utilisez agent‑browser pour tester les flux UI ou vérifier les déploiements directement depuis le terminal.
• Personnalisabilité – Définissez les règles du projet, les remplacements de modèles et même des notifications webhook pour Discord, Slack ou des services personnalisés.
• Sandboxing léger – Pour les monorepos avec de gigantesques node_modules, Ralphy propose un mode sandbox pour éviter les copies d'une même dépendance.

Commencer

Installation (npm)

npm install -g ralphy-cli

Installation (clone Git)

git clone https://github.com/michaelshimeles/ralphy.git
cd ralphy
chmod +x ralphy.sh
./ralphy.sh "add login button"

Les deux méthodes d'installation exposent le même jeu de commandes ; le script shell est pratique pour les environnements n'ayant pas Node.js.

Scénarios d'utilisation

Tâche unique

ralphy "add dark mode"
ralphy "fix the auth bug"

PRD complet

Placez un fichier Markdown nommé PRD.md à la racine de votre dépôt :

# Product Requirement Document

## Tasks
- [ ] create auth
- [ ] add dashboard
- [ ] setup CI/CD

Ensuite lancez :

ralphy --prd PRD.md

Configurer le projet

ralphy --init   # détecte automatiquement les paramètres comme la langue, le framework
ralphy --add-rule "use TypeScript strict mode"   # ajouter une règle personnalisée à la configuration
ralphy --config   # afficher la configuration actuelle

Moteurs parallèles

Accélérez le travail en exécutant plusieurs agents simultanément :

ralphy --parallel          # 3 agents par défaut
ralphy --parallel --max-parallel 5   # augmenter le pool

Workflow branche par tâche

ralphy --branch-per-task --create-pr --draft-pr

Cela crée une branche feature pour chaque tâche (par ex., ralphy/create-auth), fusionne les changements automatiquement, et peut même ouvrir des PRs brouillon.

Fonctionnalités avancées

• Remplacement de modèle – ralphy --model sonnet "add feature" ou ralphy --sonnet "add feature".
• Arguments spécifiques au moteur – Passez les indicateurs CLI après -- à la moteur sous-jacent.
• Notifications webhook – Ajoutez les URLs discord_webhook, slack_webhook ou custom_webhook dans .ralphy/config.yaml pour des mises à jour en temps réel.
• Automatisation du navigateur – Activez avec --browser ; Ralphy invoquera agent-browser pour effectuer des clics, taper dans des champs et prendre des captures d'écran.
• Mode sandbox – Utilisez --sandbox pour des clones plus rapides qui créent des liens symboliques vers de grands arbres de dépendances.

Obtenir de l'aide et contribuer

Le projet est ouvert aux contributions. Rejoignez la communauté sur Discord, soumettez des pull requests ou ouvrez des issues sur GitHub. Le README du dépôt contient des documents détaillés, des exemples de PRDs et des entrées de changelog.

Conclusion

Ralphy comble le fossé entre les spécifications produits et le code, automatisant la majorité du travail fastidieux qui ralentit le développement. En tirant parti de plusieurs LLM, de l'exécution parallèle et des PRs automatiquement fusionnées, il transforme un simple PRD en fonctionnalités réellement exécutables – le tout depuis le confort de votre terminal. Que vous soyez un développeur solo désireux d'accélérer vos tâches ou une équipe visant à standardiser la programmation pilotée par l'IA, Ralphy est un outil qui mérite d'être intégré à votre stack de développement.