Saltar al contenido principal
Narya ejecuta agentes de programación detrás de una sola API HTTP. Un host de larga vida posee las sesiones, el almacén y las conexiones con los modelos, en tu propia máquina o en un home que aloja Lerian. El cliente de terminal y el comando de un solo turno que entrega Lerian usan esa API. Un cliente que tú escribas usa esa misma API. El host posee cada sesión. En tu propia máquina, los clientes lo alcanzan por un socket Unix dentro de tu directorio home de Narya, y puedes empezar sin autenticación. El trabajo que llega a tu organización más allá de esta máquina, como un recurso compartido, exige autenticación, y narya login te la da. Una sesión que compartes se copia al home de tu organización.

Sesiones, lanes, checkpoints y rewinds


Una sesión es una conversación duradera ligada a una ruta de repositorio. Sobrevive al proceso que la abrió. Una sesión archivada no recibe trabajo nuevo, y nada la devuelve. La transcripción sigue siendo consultable y exportable. Un lane es una vía paralela dentro de una sesión. El lane principal lleva tu propia conversación. Los otros lanes llevan trabajo delegado y conversaciones laterales. La salida simple lleva solo la respuesta a tu prompt. La salida --json lleva cada lane y etiqueta cada línea con su id de lane. Un checkpoint es un punto de restauración de tu árbol de trabajo. Narya crea checkpoints solo dentro de un repositorio git. Los guarda en un repositorio git paralelo junto a tu checkout, nunca en tu propio historial. Los checkpoints son permanentes y ningún temporizador los elimina. Un rewind mueve una sesión hacia atrás en la conversación, en los archivos o en ambos. El alcance no tiene valor predeterminado, así que debes indicar cuál de los tres quieres. Antes de que un rewind mueva archivos, Narya registra el árbol tal como está. Un rewind no borra ningún mensaje ni ningún checkpoint.

Los clientes que entrega Lerian


Ejecuta narya sin argumentos para abrir el cliente interactivo. El cliente necesita una terminal tanto en la entrada estándar como en la salida estándar. Agrega --tui para el diseño de pantalla completa o --no-tui para el diseño en línea. Agrega -s <session-id> para retomar una sesión. Ejecuta narya -p "<prompt>" para un prompt y una respuesta. Esta es la forma que usa un pipeline. Cada comando acepta --json.

Una API, cualquier cliente


Ambos clientes entregados usan una sola API HTTP, y ella lleva el trabajo: sesiones, lanes, mensajes, permisos, programaciones y workflows. En tu propia máquina, el host la sirve por un socket Unix en tu home de Narya. El cliente de terminal la usa. El comando de un solo turno también la usa, siempre que un host responda en el socket. Un cliente que escribas contra el mismo contrato alcanza las mismas operaciones. La API del host describe el transporte, el stream de eventos y los envelopes.

Dónde guarda Narya tus datos


Narya escribe en ~/.config/narya de forma predeterminada, o en $XDG_CONFIG_HOME/narya cuando esa variable está definida. Define NARYA_HOME para mover esa raíz a cualquier otro lugar. Narya crea el directorio con permisos 0700. La raíz contiene el almacén SQLite, el socket local, tu config.toml y tus reglas de permisos. También contiene el directorio de credenciales, el directorio de identidad, los directorios de spill y de medios, y el archivo de log.

Qué lee Narya de tu configuración existente


Narya lee los formatos propios de Claude Code sin ningún cambio: agentes, skills y comandos bajo ~/.claude, y la tabla hooks de ~/.claude/settings.json. Lee los mismos recursos de un repositorio en el que confías. Los servidores de herramientas MCP se conectan a través de config.toml y del .mcp.json de un repositorio en el que confías.

Cómo obtienes Narya


Lerian entrega Narya a instituciones con licencia. Ejecutas el host en tu propia máquina, o Lerian aloja un home para tu organización, donde cada sesión se ejecuta en un contenedor. Consulta Ejecuta Narya. Contacta a tu equipo de cuenta de Lerian para obtener acceso.

Lee a continuación


Ejecuta Narya

La autenticación, el host, el servicio de inicio de sesión, las sesiones y los comandos de salud.

Modelos y credenciales

Los tres proveedores de modelos, de dónde viene tu clave y qué sale de tu máquina.

Permisos y confianza

La pregunta de confianza, el formato de las reglas y la auditoría que consultas.

Automatización y CI

Ejecuciones de un solo turno, códigos de salida, programaciones y workflows.

Extender Narya

Servidores de herramientas, scripts confinados, la API del host, agentes y hooks.

La API del host

Un contrato para cada cliente: socket, stream de eventos, envelopes.