Sobre el proyecto

Reel es una herramienta de código abierto diseñada para crear demos-as-code para aplicaciones web y interfaces de línea de comandos. Utiliza una pequeña especificación en YAML que controla la aplicación real, ya sea en un navegador Chromium mediante Playwright o en un terminal real, y registra lo que realmente sucede. El video grabado se convierte luego en GIFs, archivos MP4, WebM, guiones gráficos en PNG y composiciones HTML interactivas impulsadas por HyperFrames. El flujo de trabajo se centra en un archivo de especificación: se escribe o captura, se ejecuta `reel check` para verificar que cada paso siga funcionando, y luego `reel shoot` para producir el video. `reel compose` crea un proyecto HyperFrames, y los autores rellenan las descripciones de escenas antes de renderizar. Características clave: - **Modo de captura**: permite conducir manualmente la aplicación y dejar que Reel escriba automáticamente la especificación, incluyendo selectores de accesibilidad estables. - **Gramática de escenas**: tarjetas de título, llamadas de atención, resaltados, transiciones, diagramas (Mermaid), acercamientos, desplazamientos y gestos de arrastre estructurados en secuencias dirigidas en lugar de grabaciones sin procesar. - **Preajustes de entrega**: salidas optimizadas para READMEs, redes sociales, documentación y compartir con alta fidelidad. - **Audio**: narración opcional mediante ElevenLabs u OpenAI, efectos de sonido sintetizados, música de fondo con atenuación y sincronización de imagen con voz. - **Subtítulos y localización**: archivos SRT/VTT auxiliares con variantes traducidas por LLM por idioma. - **Manejo de autenticación**: iniciar sesión una vez fuera de cámara con una sesión guardada de Playwright; las demostraciones se reproducen autenticadas sin exponer contraseñas en las especificaciones. - **Determinismo**: congela los relojes, deshabilita animaciones, fija la configuración regional y zona horaria para renderizados reproducibles. - **Complemento Claude Code**: construye y mejora demos mediante lenguaje natural usando las habilidades `/reel` y `/reel-polish`. - **Interfaz de estudio**: una interfaz local basada en Next.js para edición de especificaciones, grabación con vista previa en vivo, creación con IA y verificación de desviaciones. - **Integración con CI**: `reel check` actúa como una prueba de humo que falla el pipeline cuando se rompen flujos de demostración. - **Soporte de editor**: autocompletado automático del esquema YAML para VS Code, JetBrains y Neovim. Todo funciona localmente: licencia MIT al 100%, sin SaaS ni necesidad de alojamiento. Requiere Node.js 22+ y TypeScript.