> ## 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. # O que é o Narya? > O Narya roda agentes de código atrás de uma API HTTP. Um host na sua máquina é dono das sessões e do armazenamento, e todo cliente conduz o mesmo contrato. O Narya roda agentes de código atrás de uma API HTTP. Um host de vida longa na sua máquina é dono das sessões, do armazenamento e das conexões com os modelos. 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. Os clientes chegam a ele por um socket Unix dentro da sua pasta Narya. O Narya guarda suas sessões e transcrições na sua própria máquina. ## 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. Você pode arquivar uma sessão para escondê-la de uma listagem. 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 mostra apenas a faixa principal. 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 guarda os checkpoints 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. Uma rebobinagem sempre ramifica e nunca apaga. O Narya primeiro transforma a árvore como ela está no ponto de restauração dela. O escopo não tem padrão, então você deve dizer qual dos três quer. ## 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 ` para retomar uma sessão. Rode `narya -p ""` para um turno 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. O host a serve por um socket Unix na sua pasta Narya, e ela carrega o trabalho: sessões, faixas, mensagens, permissões, agendamentos e workflows. 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](/pt/platform/narya/the-host-api) 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. Defina `NARYA_HOME` para mover essa raiz para 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, as pastas de spill e de mídia por sessão 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`. ## Como você obtém o Narya *** A Lerian entrega o Narya aos clientes licenciados. Fale com seu time de conta Lerian para obter acesso. ## Leia a seguir *** O host, o serviço de login, as sessões e os comandos de saúde. Os três fornecedores de modelo, de onde vem a sua chave e o que sai da sua máquina. A pergunta de confiança, o formato das regras e a auditoria que você lê de volta. Execuções únicas, códigos de saída, agendamentos e workflows. Servidores de ferramentas, scripts confinados, a API do host, agentes e hooks. Um contrato para todo cliente: socket, stream de eventos, envelopes.