Ruflo
Desplegar Ruflo con control: hooks, resolución CLI y rutas locales de memoria
Prepara una instalación aislada con cambios explícitos, dependencias resueltas, comprobaciones del lanzador MCP y archivos locales de resolución.
Qué aprenderás
- Decide qué puede cambiar
- Resuelve el ejecutable que realmente arrancará
- Separa datos y resolución de la máquina
Antes de empezar
- Conceptos básicos de Node.js, Git y terminal
- Repositorio propio y límites de tarea y permisos definidos
Explica el código del capítulo y reproduce su prueba acotada sin confundir un ayudante con todo el runtime.
Conclusiones clave
- La inicialización cambia archivos: conserva y revisa un diff recuperable.
- El plugin central incluye hooks y una ruta de arranque real.
- Fijar el envoltorio y copiar rutas locales no fija todo el despliegue.
Decide qué puede cambiar
La inicialización CLI modifica el espacio de trabajo; no es una consulta de salud. El README incluye .claude, .claude-flow, CLAUDE.md, ayudantes y ajustes entre sus salidas. Usa un checkout aislado o conserva una base recuperable y examina el diff. No inicialices un repositorio activo únicamente para completar un comando de tutorial.
Un plugin puede dejar menos archivos en el proyecto, pero ruflo-core declara servidor MCP y hooks. Revisa manifiesto, .mcp.json y hooks/hooks.json juntos. La tabla raíz que resume los plugins como carentes de hooks no describe correctamente este plugin central en la revisión fijada. Inspecciona la superficie real de ambas opciones.
Resuelve el ejecutable que realmente arrancará
El lanzador MCP examina candidatos locales y exige bin/cli.js junto con dist/src/index.js. Un checkout sin construir no debe ganar solo porque exista el binario de entrada. Se selecciona el primer candidato válido, incluyendo una ubicación del marketplace situada antes de node_modules del proyecto.
Sin candidato local, utiliza npx -y @claude-flow/cli@latest mcp start. El envoltorio también declara un rango de dependencia con caret. Fijar solamente ruflo o el checkout Git no garantiza reproducibilidad completa: registra árbol resuelto, ejecutable elegido y comportamiento sin conexión. Una etiqueta de versión no sustituye esas comprobaciones.
Separa datos y resolución de la máquina
El resolvedor de memoria puede escribir distPath absoluto, versión, operación y fecha en .claude-flow/memory-package.json. Busca primero ese archivo, después resolución desde el proyecto y finalmente node_modules en directorios superiores. Facilita reutilizar un paquete del caché npx, pero la ruta absoluta pertenece a la máquina, no a datos portables del proyecto.
El comando siguiente es una referencia no ejecutada para el checkout aislado, no un servicio iniciado. Verifica herramientas, versiones efectivas, archivos generados, destino de memoria y recuperación. Repite en otra máquina en vez de asumir que las rutas copiadas y paquetes cacheados siguen disponibles. Conserva siempre la configuración existente.
Pasos de implementación
- 1
Crea un checkout aislado autorizado y registra su base.
- 2
Revisa manifiestos, hooks y resolución.
- 3
Inicializa solo dentro del alcance elegido.
- 4
Comprueba runtime, datos y recuperación antes de ampliar.
Ejemplo para copiar
npx ruflo@3.38.23 initPreguntas frecuentes
¿Fijar ruflo fija la CLI de todos los plugins?
No. Existen un rango de dependencia y una alternativa @latest. Inspecciona el ejecutable y árbol realmente resueltos.
¿Conviene copiar memory-package.json entre máquinas?
Contiene una ruta absoluta local. Verifica o regenera la resolución en destino en lugar de asumir portabilidad.
Fuentes
- README.mdFuente verificada 2026-09-08
- ruflo/package.jsonFuente verificada 2026-09-08
- ruflo/bin/ruflo.jsFuente verificada 2026-09-08
- plugins/ruflo-core/.claude-plugin/plugin.jsonFuente verificada 2026-09-08
- plugins/ruflo-core/.mcp.jsonFuente verificada 2026-09-08
- plugins/ruflo-core/hooks/hooks.jsonFuente verificada 2026-09-08
- plugins/ruflo-core/scripts/mcp-launch.cjsFuente verificada 2026-09-08
- v3/@claude-flow/cli/src/init/memory-package-resolver.tsFuente verificada 2026-09-08