CLI ↔ escritorio

La CLI y la app de escritorio son dos clientes del mismo motor. Las sesiones, los proveedores y el estado de los proyectos viven en el motor, así que puedes empezar en la terminal y seguir en el escritorio sin perder el historial.

Abrir la app de escritorio desde una terminal

Desde la carpeta en la que trabajas:

rinari desktop .

Abre Rinari Agent en ese proyecto. Para continuar una sesión concreta:

rinari desktop . --session <id-de-sesión>

Si la app ya está abierta, la petición va a la ventana en marcha en lugar de abrir otra.

• rinari code es un alias de compatibilidad de rinari desktop.
• rinari agent es otro comando: ejecuta una tarea en la terminal y no abre la app de escritorio.

Cómo encuentra la app rinari desktop

El comando busca el ejecutable de escritorio en este orden, y nunca adivina rutas de instalación:

1. La opción --binary <ruta>.
2. La variable de entorno RINARI_AGENT_BIN.
3. RINARI_CODE_BIN, el nombre antiguo.
4. rinari-agent en el PATH.
5. rinari-code en el PATH, el nombre antiguo.

Si --binary o una de las variables apunta a un archivo que no existe, el comando falla en lugar de abrir otra cosa.

Con el instalador

Si marcaste Agregar Rinari CLI al PATH al instalar, el comando rinari que se instaló ya fija RINARI_AGENT_BIN en tu instalación. rinari desktop . funciona sin configurar nada más.

Con una CLI instalada por separado

Si usas la CLI desde el código fuente o la instalaste con uv tool install, indícale dónde está la app. En PowerShell, para una instalación Solo para mí en la carpeta predeterminada:

$env:RINARI_AGENT_BIN = "$env:LOCALAPPDATA\Programs\Rinari Agent\rinari-agent.exe"
rinari desktop .

Para conservar la variable en todas las terminales, créala como variable de entorno de usuario en Windows.

De vuelta a la terminal

Retoma la sesión compatible más reciente del proyecto actual, o una concreta:

rinari resume
rinari resume <id-de-sesión>

Al retomar, el motor vuelve a comprobar los hechos duraderos —proyecto, rama, cambios sin confirmar, proveedor, confianza, carpeta de trabajo— e informa lo que cambió como avisos en lugar de corregirlo en silencio.

Dónde vive el estado

El motor guarda su estado en ~/.rinari de forma predeterminada, o en la carpeta que indique RINARI_HOME. Los dos clientes leen el mismo estado. No muevas ni reemplaces esa carpeta para «reiniciar» Rinari: perderías sesiones y configuración. Exporta antes lo que necesites:

rinari export session
rinari export config     # los secretos nunca se exportan