Skip to main content
O Narya se divide entre um host e seus clientes. O host é dono do armazenamento, das sessões e das conexões com os modelos. Um cliente envia uma mensagem e lê o resultado pelo socket local. Um cliente interativo começa um host quando nenhum host responde, e depois o conduz pela mesma API HTTP que todos os outros clientes.

​
O host

1

Comece o host

Rode narya host start. O host toma o lock do armazenamento e escuta no socket dentro da sua pasta Narya.
2

Verifique

Rode narya host status. Ele informa o host que encontrou e o que esse host serve.
3

Pare o host

Rode narya host stop. O host termina as requisições em andamento e depois solta o lock do armazenamento.

​
Manter o host vivo entre logins

O narya daemon install grava um serviço de login e o carrega. No macOS ele grava um LaunchAgent que roda narya host start no carregamento e o reinicia. No Linux ele grava uma unit systemd de usuário que reinicia em caso de falha. O Narya grava a unit com permissões 0600. Ele define NARYA_HOME dentro da unit em vez de herdar o valor. O narya daemon status responde três perguntas em separado: registrado, carregado e servindo. O narya daemon uninstall remove a unit e nada mais. Suas sessões, seu armazenamento e sua configuração continuam. O host e cada sessão dentro dele sobrevivem a um terminal fechado. Um narya -p posterior se conecta ao host em execução em vez de abrir o armazenamento por conta própria.
O narya daemon install é o único comando que grava uma unit de serviço. Nada mais no Narya grava uma.

​
Sessões

Cada sessão se liga a um caminho de repositório. Retome uma com narya -s <session-id> ou com narya -p --session <session-id>.
  • O narya session list lista as sessões no armazenamento.
  • O narya export <session-id> grava uma transcrição na saída padrão. Escolha --format markdown ou --format jsonl. Adicione --reasoning e --tool-output para mais detalhe.
  • O narya import <file> --repository <absolute path> lê uma transcrição de outra ferramenta. Defina --format claudecode ou --format opencode.
  • O narya session promote <session-id> marca a sessão como acompanhada.

​
Checkpoints e rebobinagens

O Narya registra pontos de restauração da sua árvore de trabalho em um repositório git sombra ao lado do seu checkout. Seu próprio histórico git nunca muda. Nenhum temporizador remove um checkpoint. Uma rebobinagem leva uma sessão para trás na conversa, nos arquivos, ou em ambos. Diga o escopo, porque ele não tem padrão. Uma rebobinagem sempre ramifica e nunca apaga. O Narya primeiro registra a árvore como ela está, então o estado que você deixa vira um ponto de restauração próprio.

​
Saúde e reparo

O narya doctor percorre a instalação e informa o que encontra:
  • a pasta raiz e a configuração
  • o host e o armazenamento
  • as sessões e os servidores de ferramentas
  • as credenciais
  • o binário e o terminal
Ele não repara nada. Cada achado nomeia o comando que o corrige. O narya repair <session-id> é a saída de uma quarentena. Um desligamento sujo deixa uma sessão para recuperação, e esse comando a solta. Adicione --retire para fechar a sessão em vez disso.

​
Retenção

O Narya guarda tudo até você dizer o contrário. Defina uma idade máxima por classe em [retention] no config.toml.
  • O narya retention status informa o que uma varredura removeria.
  • O narya retention run faz a varredura.
  • O narya purge <session-id> --yes remove uma sessão e tudo abaixo dela.