Introducción a Ralphy

\n

En la era de ciclos de desarrollo rápidos, los desarrolladores están constantemente buscando formas de reducir las tareas de codificación repetitivas. Ralphy ofrece una solución única: una interfaz de línea de comandos autónoma (CLI) que recorre automáticamente una serie de motores de IA—Claude Code, Codex, OpenCode, Cursor, Qwen, Factory Droid, y GitHub Copilot—para convertir un documento de requisitos de producto (PRD) en código real.

\n\n

Por qué Ralphy destaca

\n

\n
• Soporte multi-motor – Cambia entre modelos de IA al instante o ejecútalos en paralelo para obtener retroalimentación más rápida.
\n
• Automatización de tareas – Un único comando puede generar una funcionalidad totalmente funcional, o puedes alimentar un PRD completo con tareas ya enumeradas.
\n
• Resolución inteligente de conflictos – Cuando los agentes se ejecutan en paralelo, Ralphy fusiona automáticamente las ramas y resuelve la mayoría de los conflictos.
\n
• Automatización del navegador – Usa agent-browser para probar flujos de UI o verificar despliegues directamente desde el terminal.
\n
• Personalización – Define reglas de proyecto, anulaciones de modelos e incluso notificaciones webhook para Discord, Slack o servicios personalizados.
\n
• Sandbox ligero – Para monorepos con enormes node_modules, Ralphy ofrece modo sandbox para evitar copias duplicadas de dependencias.
\n

\n\n

Primeros pasos

\n

Instalación (npm)

\n

npm install -g ralphy-cli\n

\n

Instalación (Git Clone)

\n

git clone https://github.com/michaelshimeles/ralphy.git\ncd ralphy\nchmod +x ralphy.sh\n./ralphy.sh "add login button"\n

\n

Ambos métodos de instalación exponen el mismo conjunto de comandos; el script de shell es útil para entornos que no tienen Node.js.

\n\n

Escenarios de uso

\n

Tarea única

\n

ralphy "add dark mode"\nralphy "fix the auth bug"\n

\n

PRD completo

\n

Coloca un archivo Markdown llamado PRD.md en la raíz de tu repositorio:

\n

# Product Requirement Document\n\n## Tasks\n- [ ] create auth\n- [ ] add dashboard\n- [ ] setup CI/CD\n

\n

Luego ejecuta:

ralphy --prd PRD.md

\n

Configurar el proyecto

\n

ralphy --init   # auto‑detects settings like language, framework\nralphy --add-rule "use TypeScript strict mode"   # add custom rule to config\nralphy --config   # view current configuration\n

\n\n

Engines en paralelo

\n

Acelera el trabajo ejecutando múltiples agentes simultáneamente:

\n

ralphy --parallel          # 3 agents by default\nralphy --parallel --max-parallel 5   # increase pool\n

\n\n

Flujo de trabajo rama por tarea

\n

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

\n

Esto crea una rama de característica para cada tarea (p. ej., ralphy/create-auth), fusiona los cambios automáticamente e incluso puede abrir PRs borrador.

\n\n

Funciones avanzadas

\n

\n
• Anulación de modelo – ralphy --model sonnet "add feature" o ralphy --sonnet "add feature".
\n
• Argumentos específicos del motor – Pasa banderas CLI después de -- al motor subyacente.
\n
• Notificaciones webhook – Añade URLs discord_webhook, slack_webhook, o custom_webhook en .ralphy/config.yaml para actualizaciones en tiempo real.
\n
• Automatización del navegador – Actívalo con --browser; Ralphy invocará agent-browser para realizar clics, escribir en campos y tomar capturas de pantalla.
\n
• Modo Sandbox – Usa --sandbox para clones más rápidos que enlazan arboles de dependencias grandes.
\n

\n\n

Obtener ayuda y contribuir

\n

El proyecto está abierto a contribuciones. Únete a la comunidad en Discord, envía pull requests o abre issues en GitHub. El README del repositorio contiene documentación detallada, ejemplos de PRDs y entradas de changelog.

\n\n

Conclusión

\n

Ralphy cierra la brecha entre las especificaciones de producto y el código, automatizando la mayor parte del trabajo pesado que ralentiza el desarrollo. Al aprovechar múltiples LLMs, la ejecución paralela y PRs auto‑fusionados, convierte un PRD sencillo en características reales y ejecutables—todo desde la comodidad de tu terminal. Ya sea que seas un desarrollador en solitario que busca acelerar las tareas o un equipo que desee estandarizar la codificación impulsada por IA, Ralphy es una herramienta que vale la pena añadir a tu stack de desarrollo.