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

# ¿Qué es Narya?

> Narya ejecuta agentes de programación detrás de una sola API HTTP. Un host en tu máquina posee las sesiones y el almacén, y cada cliente usa el mismo contrato.

Narya ejecuta agentes de programación detrás de una sola API HTTP. Un host de larga vida en tu máquina posee las sesiones, el almacén y las conexiones con los modelos. 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. Los clientes lo alcanzan por un socket Unix dentro de tu directorio home de Narya. Narya guarda tus sesiones y transcripciones en tu propia máquina.

## 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ó. Puedes archivar una sesión para ocultarla de un listado. 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 muestra solo el lane principal. 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 guarda los checkpoints 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. Un rewind siempre crea una rama y nunca borra. Narya primero convierte el árbol tal como está en su propio punto de restauración. El alcance no tiene valor predeterminado, así que debes indicar cuál de los tres quieres.

## 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 turno 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. El host la sirve por un socket Unix en tu home de Narya, y ella lleva el trabajo: sesiones, lanes, mensajes, permisos, programaciones y workflows. 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](/es/platform/narya/the-host-api) describe el transporte, el stream de eventos y los envelopes.

## Dónde guarda Narya tus datos

***

Narya escribe en `~/.config/narya` de forma predeterminada. Define `NARYA_HOME` para mover esa raíz a 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, los directorios de spill y de medios por sesión, 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`.

## Cómo obtienes Narya

***

Lerian entrega Narya a clientes con licencia. Contacta a tu equipo de cuenta de Lerian para obtener acceso.

## Lee a continuación

***

<Columns cols={2}>
  <Card title="Ejecuta Narya" icon="terminal" href="/es/platform/narya/running-narya">
    El host, el servicio de inicio de sesión, las sesiones y los comandos de salud.
  </Card>

  <Card title="Modelos y credenciales" icon="key" href="/es/platform/narya/models-and-credentials">
    Los tres proveedores de modelos, de dónde viene tu clave y qué sale de tu máquina.
  </Card>

  <Card title="Permisos y confianza" icon="shield-check" href="/es/platform/narya/permissions-and-trust">
    La pregunta de confianza, el formato de las reglas y la auditoría que consultas.
  </Card>

  <Card title="Automatización y CI" icon="gear" href="/es/platform/narya/automation-and-ci">
    Ejecuciones de un solo turno, códigos de salida, programaciones y workflows.
  </Card>

  <Card title="Extender Narya" icon="puzzle-piece" href="/es/platform/narya/extending-narya">
    Servidores de herramientas, scripts confinados, la API del host, agentes y hooks.
  </Card>

  <Card title="La API del host" icon="plug" href="/es/platform/narya/the-host-api">
    Un contrato para cada cliente: socket, stream de eventos, envelopes.
  </Card>
</Columns>
