Preguntas frecuentes
Respuestas a tus preguntas sobre RunWhale
Respuestas claras para empezar, saber qué se ejecuta en el teléfono, conocer los límites y comprobar rápidamente los fallos.
Última actualización:
Elige una pregunta. Las respuestas describen los límites actuales sin presuponer un proveedor, una versión de dispositivo o un canal de distribución concreto.
Primeros pasos
¿Qué necesito antes de usar el agente por primera vez?
Elige un proveedor y modelo en Ajustes → Modelos, guarda una clave API válida y mantén el dispositivo conectado. Después crea un proyecto Web o Expo, o importa un repositorio compatible.
¿Debo elegir Web o Expo?
Elige Web para un sitio React en la vista previa Web. Elige Expo para un proyecto React Native en la vista previa nativa dentro del contenedor nativo fijo de RunWhale. Ambas plantillas comparten el flujo de proyectos y agente.
¿Puedo importar un repositorio existente?
Sí, si es compatible con el entorno Web o Expo de RunWhale. El archivo runwhale.json declara las entradas y el destino de vista previa. Los repositorios que requieren código nativo, binarios o pasos de compilación no admitidos quedan fuera del entorno actual.
Entorno local y datos
¿Todo se ejecuta localmente? ¿Funciona sin conexión?
Los archivos, la coordinación del agente, las sesiones, Node.js, TypeScript, las tareas admitidas, Git, Metro y la vista previa se ejecutan en el teléfono. La inferencia usa el proveedor remoto configurado. Las operaciones de red de Git y las dependencias sin caché también usan red; RunWhale no es un producto sin conexión.
¿Qué datos del proyecto puede recibir el proveedor del modelo?
Al usar el agente, RunWhale envía tu petición y el contexto necesario del proyecto o sesión al proveedor seleccionado. Según la solicitud, puede incluir código, archivos, imágenes, resultados de herramientas e historial de conversación.
¿Dónde se guardan las credenciales de API y Git?
Las claves API y la clave privada de Git del dispositivo permanecen en iOS Keychain o Android Keystore. No se escriben en archivos de proyecto, variables de entorno, configuración de Git, sesiones, registros ni paquetes de vista previa.
Compatibilidad y límites
¿Puedo usar un repositorio Git privado?
Sí, con repositorios GitHub por SSH. En Ajustes → Clave SSH de Git, genera o copia la clave pública del dispositivo, añádela a GitHub y usa la URL SSH del repositorio. La clave privada permanece en el almacenamiento seguro; el acceso depende de la red y de los permisos en GitHub.
¿Puede un proyecto instalar cualquier paquete npm?
No. Se admiten paquetes JavaScript puros compatibles del registro npm. Los scripts de ciclo de vida y enlaces binarios están desactivados. No se admiten dependencias Git o de rutas, complementos nativos, binarios, plugins dinámicos de Expo ni SDK nativos específicos. Según el modo de permisos, se puede solicitar tu aprobación.
¿RunWhale compila apps iOS o Android independientes?
No. Los proyectos se ejecutan como vistas previas Web o React Native dentro de RunWhale. No generan compilaciones de Xcode, Gradle, EAS, IPA ni APK.
¿El agente o Metro siguen trabajando en segundo plano?
No dependas de una ejecución continua en segundo plano. En particular, el producto actual no mantiene al agente o Metro funcionando continuamente cuando iOS pasa a segundo plano. Mantén RunWhale en primer plano durante el trabajo activo o la preparación de la vista previa.
Resolución de problemas
¿Por qué no inicia el agente?
Comprueba que el proveedor seleccionado tenga una clave API válida guardada y que haya conexión. Si aparece un error del entorno local, reinícialo y vuelve a intentarlo antes de modificar el proyecto.
¿Por qué no abre la vista previa Web o nativa?
Pulsa Ejecutar / Recargar y comprueba que runwhale.json declare el destino y una entrada Web o nativa correspondiente. Lee el diagnóstico de Metro o de la vista previa y usa ese mensaje exacto, sin datos sensibles, al pedir la corrección.
¿Por qué falló clone, fetch, pull o push de Git?
Comprueba que se use una URL HTTPS admitida o una URL SSH de GitHub. Revisa la rama, la conexión y los permisos remotos. Para SSH, confirma que la clave pública actual esté registrada en GitHub. Pull requiere además un árbol de trabajo limpio; las URL con credenciales incrustadas se rechazan.
¿Qué debo incluir al informar de un problema?
Incluye la versión de RunWhale, modelo y sistema operativo del dispositivo, acción intentada, error exacto, pasos mínimos para reproducirlo y diagnósticos no sensibles. Nunca incluyas claves API o privadas, credenciales, datos privados del proyecto, datos personales ni registros o capturas sin depurar.
¿Necesitas más ayuda?
Sigue la guía paso a paso para tu primer flujo completo, o contacta con soporte si tienes una consulta privada o un problema reproducible.