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 <session-id> para retomar uma sessão.
Rode narya -p "<prompt>" 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 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
Rodar o Narya
O host, o serviço de login, as sessões e os comandos de saúde.
Modelos e credenciais
Os três fornecedores de modelo, de onde vem a sua chave e o que sai da sua máquina.
Permissões e confiança
A pergunta de confiança, o formato das regras e a auditoria que você lê de volta.
Automação e CI
Execuções únicas, códigos de saída, agendamentos e workflows.
Estender o Narya
Servidores de ferramentas, scripts confinados, a API do host, agentes e hooks.
A API do host
Um contrato para todo cliente: socket, stream de eventos, envelopes.