> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Ejecuta Narya

> Inicia el host, instálalo como servicio de inicio de sesión, gestiona sesiones y checkpoints, y revisa la salud de tu instalación.

Narya se divide en un host y sus clientes. El host posee el almacén, las sesiones y las conexiones con los modelos. Un cliente envía un mensaje y lee el resultado por el socket local. Un cliente interactivo inicia un host cuando ningún host responde, y luego lo maneja por la misma API HTTP que cualquier otro cliente.

## El host

***

<Steps>
  <Step title="Inicia el host">
    Ejecuta `narya host start`. El host toma el bloqueo del almacén y escucha en el socket dentro de tu directorio home de Narya.
  </Step>

  <Step title="Revísalo">
    Ejecuta `narya host status`. Informa el host que encontró y qué sirve.
  </Step>

  <Step title="Detenlo">
    Ejecuta `narya host stop`. El host termina las solicitudes en curso y luego libera el bloqueo del almacén.
  </Step>
</Steps>

## Mantén el host vivo entre inicios de sesión

***

`narya daemon install` escribe un servicio de inicio de sesión y lo carga. En macOS escribe un LaunchAgent que ejecuta `narya host start` al cargarse y lo reinicia. En Linux escribe una unidad de systemd de usuario que se reinicia ante una falla. Narya escribe la unidad con permisos `0600`. Define `NARYA_HOME` dentro de la unidad en lugar de heredar el valor.

`narya daemon status` responde tres preguntas por separado: registrado, cargado y sirviendo. `narya daemon uninstall` elimina la unidad y nada más. Tus sesiones, tu almacén y tu configuración se mantienen.

El host y cada sesión dentro de él sobreviven a una terminal cerrada. Un `narya -p` posterior se conecta al host en ejecución en lugar de abrir el almacén por sí mismo.

<Note>
  `narya daemon install` es el único comando que escribe una unidad de servicio. Nada más en Narya escribe una.
</Note>

## Sesiones

***

Cada sesión se liga a una ruta de repositorio. Retoma una con `narya -s <session-id>`, o con `narya -p --session <session-id>`.

* `narya session list` lista las sesiones del almacén.
* `narya export <session-id>` escribe una transcripción en la salida estándar. Elige `--format markdown` o `--format jsonl`. Agrega `--reasoning` y `--tool-output` para más detalle.
* `narya import <file> --repository <absolute path>` lee una transcripción de otra herramienta. Define `--format claudecode` o `--format opencode`.
* `narya session promote <session-id>` marca la sesión como atendida.

## Checkpoints y rewinds

***

Narya registra puntos de restauración de tu árbol de trabajo en un repositorio git paralelo junto a tu checkout. Tu propio historial de git nunca cambia. Ningún temporizador elimina un checkpoint.

Un rewind mueve una sesión hacia atrás en la conversación, en los archivos o en ambos. Indica el alcance, porque no tiene valor predeterminado. Un rewind siempre crea una rama y nunca borra. Narya primero registra el árbol tal como está, así que el estado que dejas se convierte en su propio punto de restauración.

## Salud y reparación

***

`narya doctor` recorre la instalación e informa lo que encuentra:

* el directorio home y la configuración
* el host y el almacén
* las sesiones y los servidores de herramientas
* las credenciales
* el binario y la terminal

No repara nada. Cada hallazgo nombra el comando que lo corrige.

`narya repair <session-id>` es la salida de una cuarentena. Un apagado no limpio deja una sesión pendiente de recuperación, y este comando la libera. Agrega `--retire` para cerrar la sesión en su lugar.

## Retención

***

Narya conserva todo hasta que indiques otra cosa. Define una antigüedad máxima por clase bajo `[retention]` en `config.toml`.

* `narya retention status` informa qué eliminaría un barrido.
* `narya retention run` hace el barrido.
* `narya purge <session-id> --yes` elimina una sesión y todo lo que hay bajo ella.
