Skip to main content
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

1

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.
2

Revísalo

Ejecuta narya host status. Informa el host que encontró y qué sirve.
3

Detenlo

Ejecuta narya host stop. El host termina las solicitudes en curso y luego libera el bloqueo del almacén.

​
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.
narya daemon install es el único comando que escribe una unidad de servicio. Nada más en Narya escribe una.

​
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.