Guia de instalação
Do zero ao sistema completo, dentro do seu agente.
O Nirvana-OS não roda na web: ele vive dentro do Claude Code, Codex ou Antigravity. Você instala o engine, solta um pacote de conteúdo, cria um projeto e pede ao agente para ativar. Depois disso, você fala e o sistema despacha empresas, squads e mind-clones. Cada passo abaixo mostra o comando e a saída real do terminal.
engine→
pacote→
index→
projeto→
ativar→
pronto
1
Instale o engine
Um comando. Ele baixa o engine mais recente do GitHub, coloca a árvore de skills em ~/.nirvana/skills, liga nos runtimes que achar (~/.claude, ~/.codex, ~/.gemini, ~/.antigravity) e põe o nrv no seu PATH. É idempotente: rodar de novo sempre puxa a última versão.
iNão precisa instalar o Bun antes. Se ele não estiver na máquina, o próprio instalador o baixa (user-space, em ~/.bun, sem sudo) e continua na mesma execução.
✎
Crie do zero, só conversando
Você não precisa do Genesis Circle para ter conteúdo. O engine já é uma máquina de criação. Converse com o agente sobre a empresa que quer, refine com ele os especialistas e os squads, e mande criar. Ele constrói as empresas, os mind-clones e os squads do zero. Um diálogo real:
iIsso roda só com o engine, sem nenhum pacote. O Genesis Circle (próximo passo) é o atalho: conteúdo curado e pronto, para quando você não quer construir do zero.
2
Ou instale um pacote pronto
Se você prefere conteúdo curado em vez de criar do zero, instale um pacote. As empresas, squads e mind-clones prontos chegam em pacotes que você baixa no squads.sh. Compre ou resgate o pacote, baixe o zip pelo seu painel e descompacte-o inteiro numa pasta e rode bun setup.ts lá dentro — isso instala o conteúdo por cima do engine. O exemplo abaixo é o Genesis Circle: 42 squads, 11 empresas e 159 mind-clones.
iEngine e pacote são desacoplados: o engine é grátis e público; o pacote é o conteúdo. Se o engine ainda não estiver instalado, o próprio setup.ts o baixa antes. Ainda sem o Bun? bash setup.sh instala o Bun e chama o mesmo setup.
3
Reconstrua os índices
Depois de instalar o pacote, rode nrv index para reconstruir os registries de roteamento. É o que faz o orquestrador encontrar o squad, a empresa e o mind-clone certos para cada pedido.
4
Crie um projeto
Todo trabalho acontece dentro de um projeto: é onde ficam as regras de escopo e para onde vai tudo o que o sistema gera. Crie um com nrv init e entre nele.
5
Ative dentro do projeto
Abra o projeto no seu agente (Claude Code, Codex ou Antigravity) e peça, em linguagem natural, para ativar o Nirvana-OS, instalar as dependências de todos os squads e registrar todas as empresas, squads e mind-clones. Feito isso, o sistema está completamente instalado.
No seu agente, dentro do projeto, diga
"Ative o Nirvana-OS neste projeto: instale as dependências de todos os squads e registre todas as empresas, squads e mind-clones."
⌥
Como o Nirvana-OS processa dentro do projeto
Quando você fala, quem recebe é o orquestrador (a skill harness). Ele nunca produz o artefato: raciocina sobre as três registries, escolhe o time, escreve um brief enriquecido e despacha. Cada entidade despachada se auto-administra até terminar, verifica o próprio trabalho e devolve. Cada passo vira um evento de auditoria.
Árvore de despacho
você (linguagem natural, dentro do projeto)
│
▼
orquestrador · Skill(harness) ← nunca produz artefato; roteia + audita
│ brief_received → target_plan_committed → brief-enriched.md
▼
├─ empresa ex: juridical-singularity hierarquia de funcionários
│ └─ squad ex: nirvana-juridico-total cada funcionário chama N squads
│ └─ mind-clone ex: david-ogilvy DNA de decisão injetado
│ └─ verifica → _SUMMARY.md → verify_passed
└─ squad direto ex: nirvana-backend quando o brief casa um squad só
└─ ...
│
▼
auditoria ~/.harness-logs/<data>/audit.jsonl (cada evento = 1 linha JSON)
iCada entidade lê o brief-enriched.md, decide com defaults profissionais (registra em Premissas assumidas), rola a janela de contexto em ~70% via HANDOFF.json para não perder estado, pode recrutar sub-squads e verifica antes de declarar pronto. Um loop guard corta a iteração em tetos rígidos (12 passos, 3 repetições, 4 passos sem progresso) e escala para você em vez de girar em falso.
⌘
Como fica organizada a saída
Com escopo de projeto, tudo o que o sistema gera cai em ./outputs/ — esse é o contrato. Cada pedido vira uma pasta rastreável por trace_id, com o brief, os entregáveis por empresa e por squad, o estado para retomar, e a trilha de auditoria.
Árvore de saída no disco
~/escritorio-trabalhista/ ← seu projeto (nrv init)
├─ .env NIRVANA_SCOPE=project
├─ AGENTS.md · CLAUDE.md · GEMINI.md contrato do agente + writing contract
└─ outputs/ ← tudo que o sistema gera cai aqui
└─ <trace_id>/ uma execução = um pedido
├─ brief.md o pedido, verbatim
├─ businesses/<slug>/ entregáveis por empresa
└─ squads/<slug>/
├─ HANDOFF.json estado (retoma após /clear ou crash)
├─ audit.jsonl trilha local da execução
├─ handoffs/ passagens entre fases
└─ outputs/
├─ _SUMMARY.md o que foi entregue (lido pelas fases seguintes)
└─ <entregáveis> o trabalho final
iO _SUMMARY.md encadeia as fases (a próxima lê o resumo da anterior). O HANDOFF.json permite retomar de onde parou. E o audit.jsonl prova a execução: você confere a cadeia brief_received → dispatch → gate_passed com tail + jq. Nenhuma mensagem de "pronto" é honesta sem esses eventos.
6
Teste: pergunte o que está disponível
Para confirmar que tudo foi registrado, pergunte ao seu agente quais empresas, squads e mind-clones estão disponíveis. Ele responde a partir das três registries.
7
Exemplo real: um escritório de advocacia
O teste de fogo. Um pedido só, em linguagem natural, e o orquestrador monta o time inteiro: branding, jurídico, backend, frontend com área administrativa, e um agente de IA que conversa sobre os processos.
O pedido
"Use suas melhores empresas, agentes e mind-clones para desenvolver um sistema completo para um escritório de advocacia trabalhista:"
- Branding e identidade do escritório
- Jurídico trabalhista como base do conteúdo
- Backend em Supabase self-hosted, com RLS, auth, db e storage para cadastro de clientes e processos
- Frontend completo com área administrativa: cadastro de funcionários com permissões por role de acesso
- Agente de IA em chat que pesquisa nos processos e conversa sobre eles com os advogados
- e que também cria minutas de documentos jurídicos para os advogados
iO roster exato é escolhido pelo orquestrador em tempo de execução, conforme o brief casa cada registry. O terminal acima mostra o tipo de plano que ele fecha (target_plan_committed) e onde o trabalho é entregue.