O que é o Narya?

O Narya roda agentes de código atrás de uma API HTTP. Um host de vida longa é dono das sessões, do armazenamento e das conexões com os modelos, na sua própria máquina ou em um home que a Lerian hospeda. O cliente de terminal e o comando de execução única que a Lerian entrega conduzem essa API. Um cliente que você escreve conduz a mesma. O host é dono de cada sessão. Na sua própria máquina, os clientes chegam a ele por um socket Unix dentro da sua pasta Narya, e você pode começar sem autenticação. O trabalho que chega à sua organização além desta máquina, como um compartilhamento, exige autenticação, e narya login obtém uma para você. Uma sessão que você compartilha é copiada para o home da sua organização.

​

Sessões, faixas, checkpoints e rebobinagens

---

Uma sessão é uma conversa duradoura ligada a um caminho de repositório. Ela sobrevive ao processo que a abriu. Uma sessão arquivada não recebe trabalho novo, e nada a traz de volta. A transcrição continua consultável e exportável. Uma faixa é uma trilha paralela dentro de uma sessão. A faixa principal carrega a sua própria conversa. As outras faixas carregam trabalho delegado e conversas laterais. A saída simples carrega apenas a resposta ao seu prompt. A saída --json carrega cada faixa e marca cada linha com o id da faixa dela. Um checkpoint é um ponto de restauração da sua árvore de trabalho. O Narya cria checkpoints apenas dentro de um repositório git. Ele os guarda em um repositório git sombra ao lado do seu checkout, nunca no seu próprio histórico. Os checkpoints são permanentes, e nenhum temporizador os remove. Uma rebobinagem leva uma sessão para trás na conversa, nos arquivos, ou em ambos. O escopo não tem padrão, então você deve dizer qual dos três quer. Antes de uma rebobinagem mover arquivos, o Narya registra a árvore como ela está. Uma rebobinagem não apaga nenhuma mensagem nem nenhum checkpoint.

​

Os clientes que a Lerian entrega

---

Rode narya sem argumentos para abrir o cliente interativo. O cliente precisa de um terminal na entrada padrão e na saída padrão. Adicione --tui para o layout de tela cheia ou --no-tui para o layout em linha. Adicione -s <session-id> para retomar uma sessão. Rode narya -p "<prompt>" para um prompt e uma resposta. Esse é o formato que um pipeline usa. Todo comando aceita --json.

​

Uma API, qualquer cliente

---

Os dois clientes entregues conduzem uma API HTTP, e ela carrega o trabalho: sessões, faixas, mensagens, permissões, agendamentos e workflows. Na sua própria máquina, o host a serve por um socket Unix na sua pasta Narya. O cliente de terminal a conduz. O comando de execução única também a conduz, sempre que um host responde no socket. Um cliente que você escreve contra o mesmo contrato chega às mesmas operações. A API do host descreve o transporte, o stream de eventos e os envelopes.

​

Onde o Narya guarda seus dados

---

O Narya grava em ~/.config/narya por padrão, ou em $XDG_CONFIG_HOME/narya quando essa variável está definida. Defina NARYA_HOME para mover essa raiz para qualquer outro lugar. O Narya cria a pasta com permissões 0700. A raiz guarda o armazenamento SQLite, o socket local, seu config.toml e suas regras de permissão. Ela também guarda a pasta de credenciais, a pasta de identidade, as pastas de spill e de mídia e o arquivo de log.

​

O que o Narya lê da sua configuração atual

---

O Narya lê os próprios formatos do Claude Code sem nenhuma mudança: agentes, skills e comandos em ~/.claude, e a tabela hooks do ~/.claude/settings.json. Ele lê os mesmos recursos de um repositório em que você confia. Os servidores de ferramentas MCP se conectam pelo config.toml e pelo .mcp.json de um repositório em que você confia.

​

Como você obtém o Narya

---

A Lerian entrega o Narya às instituições licenciadas. Você roda o host na sua própria máquina, ou a Lerian hospeda um home para a sua organização, onde cada sessão roda em um contêiner. Veja Rodar o Narya. Fale com seu time de conta Lerian para obter acesso.

​

Leia a seguir

---