Solución de problemas

Empieza aquí

• En la app, la barra superior muestra el estado del motor. Si el motor no está listo, es lo primero que hay que mirar.
• En una terminal, rinari doctor revisa tu instalación sin tocar credenciales ni estado, y rinari status muestra el proveedor, el modelo, el perfil, el proyecto y la rama en uso.

rinari doctor
rinari status
rinari version

También puedes preguntarle a Rinari, desde la CLI o la app: «¿por qué no respondió el último turno?» o «revisa la sesión ses_…». Lee los registros de la sesión y del turno (solo lectura) y señala anomalías conocidas, como un turno que nunca terminó o una aprobación que nunca se resolvió.

Instalación y actualizaciones

Windows dice que el editor es desconocido

El instalador aún no está firmado, así que Windows puede mostrar un aviso de editor desconocido o detenerlo con SmartScreen. Ejecuta solo un instalador que hayas descargado de la página oficial de versiones. Consulta Instalación en Windows.

La 0.2.x ya no abre mis datos

Es lo esperado después de actualizar: la primera vez que se abre la 0.3, migra la base de datos de Rinari, y la 0.2.x se niega a abrir el esquema nuevo. Sigue con la 0.3: tus conversaciones, proyectos y proveedores se conservan. Consulta Instalación en Windows.

Actualizar, reparar o desinstalar no arranca

Necesitan que Rinari Agent esté cerrado. Cierra la app e inténtalo de nuevo.

Ya existe otro comando rinari en el PATH

El instalador encontró otro rinari antes en tu PATH; por ejemplo, una CLI instalada desde el código fuente con uv tool install. Gana el que aparece primero. Para ver cuál usa una terminal:

where.exe rinari

Quita o reordena la otra entrada si quieres el rinari del instalador, o conserva tu propia CLI e indícale dónde está la app con RINARI_AGENT_BIN (consulta CLI ↔ escritorio).

Dictado

• Rinari no tiene permiso para usar el micrófono: permítelo en la privacidad del micrófono de Windows.
• Falta descargar el modelo de dictado: descarga uno en Ajustes → Dictado.
• La transcripción tardó demasiado: elige un modelo más ligero.

Consulta Dictado.

rinari desktop

Mensaje	Qué hacer
Desktop client not found.	Instala Rinari Agent o fija RINARI_AGENT_BIN en rinari-agent.exe.
Desktop binary not found: …	La ruta de --binary o de RINARI_AGENT_BIN está mal. Corrígela; el comando no recurre a otro ejecutable.
Not a directory: …	Pasa una carpeta, no un archivo.

rinari agent ejecuta una tarea en la terminal; no es el comando que abre la app.

Proveedores y modelos

La prueba falla o se rechaza la autenticación

• Con Variable de entorno, escribe el nombre de la variable (OPENAI_API_KEY), no la clave, y comprueba que la variable exista para el proceso del motor.
• Con servidores locales, arranca primero Ollama o LM Studio y revisa el endpoint.
• Desde una terminal, rinari providers list muestra el estado de cada proveedor y rinari providers test <alias> prueba uno.

El modelo aparece pero el turno falla

Descubrir modelos solo demuestra que el catálogo es accesible. La generación, las herramientas y la visión necesitan su propio soporte: un modelo sin llamadas a herramientas no puede editar archivos ni ejecutar comandos. Para trabajar en BUILD, elige un modelo que admita herramientas.

Proyectos

No cargan las instrucciones locales, las skills o los plugins

El proyecto no es de confianza. Los proyectos no confiados no cargan sus instrucciones, skills, plugins, servidores MCP ni hooks. Confía en la carpeta desde la app o, en una terminal:

rinari trust status
rinari trust add

Si cambió su identidad Git (un remoto nuevo o un repositorio re-creado), hay que revalidar la confianza: elige Confiar de nuevo.

Al retomar aparecen avisos

Al retomar una sesión, el motor vuelve a comprobar el proyecto, la rama, los cambios sin confirmar, el proveedor, la confianza y la carpeta de trabajo, e informa las diferencias como avisos en lugar de corregirlas en silencio. Léelos antes de seguir.

Registros, estado y cómo informar un problema

• El estado del motor vive en ~/.rinari, o en RINARI_HOME si está definida. No la muevas ni la reemplaces para reiniciar Rinari: perderías sesiones y configuración.
• Trazas de sesión: rinari logs tail, rinari trace.
• Exportaciones portables: rinari export session, rinari export config (los secretos nunca se exportan).

Ajustes → Acerca de → Exportar diagnóstico guarda un ZIP con los registros de la app y del motor, los volcados de fallo y un resumen de versiones, tamaños y estado, sin mensajes, archivos ni claves. Revísalo antes de compartirlo.

Para informar un error, abre un issue con las versiones de la app y del motor, los pasos para reproducirlo y el ZIP de diagnóstico o registros sin datos sensibles. Nunca incluyas claves de proveedores ni datos privados de tus proyectos.