---

Tú hablas con tu agente. Tu agente ejecuta Nirvana.

Ya trabajas con un agente de terminal: Claude Code, Codex, Antigravity, Pi, Grok u otro. Un prompt da una buena respuesta. El trabajo real necesita un investigador, un redactor, un revisor y un operador, con un registro de quién hizo qué.

Nirvana-OS le da esa organización a tu agente. Pides en lenguaje simple, y el agente usa Nirvana para elegir las empresas, squads y mind-clones adecuados, despacharlos, revisar lo que vuelve y mostrarte el comprobante. No aprendes una interfaz nueva ni escribes comandos en el día a día. Los comandos de más abajo son la referencia que usa tu agente, y están ahí para ti cuando los quieras.

Qué es

Nirvana-OS es un sistema multiagente nativo en Bun y agnóstico de runtime. Funciona encima del agente que ya usas y nunca lo reemplaza. Trabaja con tres tipos de contenido, todos ellos carpetas en tu máquina:

Pilar	Qué es	Dónde vive
Empresas (businesses)	Organizaciones con un organigrama. Una empresa despachada se ejecuta como un solo agente que ocupa sus puestos, usa squads a través de sus fichas y canaliza mind-clones	~/businesses/
Squads	Equipos de agentes portátiles con agentes, tasks y workflows que el agente despachado sigue como su método	~/squads/
Mind-clones	DNA de persona en cinco capas, para que un agente piense y escriba con el método de un experto concreto	~/businesses/_library/dna/

El motor viene sin contenido. Creas empresas, squads y clones pidiéndoselo a tu agente, o instalas un pack de squads.sh.

Instalación

Este README describe la 0.15.1, la release estable actual, que instala el comando de una línea del principio de esta página. No hace falta Node. Si falta Bun, cualquiera de los dos instaladores lo pone en tu carpeta de usuario (~/.bun) sin sudo ni permisos de administrador y sigue adelante.

Antes de ejecutarlo:

• macOS: nada que preparar.
• Windows (PowerShell): nada que preparar, y sin permisos de administrador.
• Linux (Ubuntu): sudo apt update && sudo apt install -y curl unzip.
• Windows con WSL (Ubuntu): ejecuta wsl --install en un PowerShell abierto como administrador, reinicia, abre la app Ubuntu y crea tu usuario de Linux. Después instala curl y unzip como en Linux y ejecuta el comando bash dentro de Ubuntu. Tu agente de IA (Claude Code, Codex, Antigravity) también tiene que instalarse dentro de Ubuntu, y tus proyectos van en ~, no en /mnt/c, que es lento.

Lo que cambia en tu máquina:

• el motor en ~/.nirvana/skills;
• la skill nirvana enlazada en cada runtime de agente que encuentra: ~/.claude/skills, ~/.codex/skills, ~/.gemini/config/skills (Antigravity), ~/.pi/agent/skills y ~/.agents/skills (OpenClaw);
• nrv y nrv-hermes en ~/.local/bin, más una línea de PATH en el perfil de tu shell (el PATH del usuario en Windows);
• hooks de auditoría en Claude Code, Antigravity y Codex;
• las carpetas de contenido vacías ~/squads, ~/businesses y ~/businesses/_library/dna.

Volver a ejecutarlo es seguro. Cierra la terminal y abre una nueva para que nrv esté en tu PATH, y compruébalo con nrv --version; muestra 0.15.1. Después pídele a tu agente: "Comprueba que Nirvana-OS está bien instalado." Ejecuta nrv doctor. La salida 1 significa solo avisos; la salida 2 lista lo que falló.

Con curl | bash el instalador no hace preguntas. Para elegir un perfil de rendimiento al instalar, pásalo así: cambia el bash final por bash -s -- --profile=balanced. También puedes fijarlo más tarde pidiéndoselo a tu agente (ver Configuración).

La guía paso a paso de cada sistema está en el sitio de documentación (en portugués), con una página para las betas, y en INSTALL.md, junto con las otras vías (la skill nirvana a través de skills.sh, instalar desde un clon).

Empieza un proyecto

Abre la carpeta en la que quieres trabajar, inicia ahí tu agente y di: "Configura esta carpeta como un proyecto de Nirvana-OS." El agente ejecuta nrv init ., que escribe .nirvana/project.yaml y una nota breve en AGENTS.md, CLAUDE.md y GEMINI.md. Los entregables quedan en outputs/ dentro del proyecto.

Esa nota mantiene a tu agente trabajando como siempre. Usa Nirvana solo cuando tu pedido lo requiere:

• lo nombras ("usa Nirvana para…", "vía nirvana");
• nombras o señalas una de tus empresas, squads o mind-clones ("mi empresa de lanzamientos", "el squad de copy", "con la voz de Hormozi"), incluido el nombre de un pack;
• pides que el trabajo, o parte de él, corra en otro runtime ("usa Codex para revisarlo").

Si quieres que Nirvana orqueste cada entregable de un proyecto, di "orquesta todo en este proyecto con Nirvana". El agente ejecuta nrv init . --orchestrators=always. Abre una sesión nueva para que el cambio surta efecto. Un proyecto preparado en 0.14 conserva su contrato completo hasta que vuelves a ejecutar nrv init ., que lo cambia, en su sitio, por la nota bajo demanda (--orchestrators=always conserva el contrato completo) y mantiene tus propias líneas.

A partir de ahí hablas con tu agente en lenguaje natural y él usa Nirvana-OS. No escribes comandos en el día a día.

Qué pedirle a tu agente

Tú dices	Tu agente ejecuta
"¿Qué empresas / squads / mind-clones tengo?"	nrv list-businesses, nrv list-squads, nrv list-clones
"Usa Nirvana para escribir el copy de lanzamiento de X."	el harness: elige la empresa, escribe un brief, nrv dispatch … --exec
"Pasa esto por el squad de copy, en Codex."	nrv dispatch --squad <slug> … --exec --runtime codex
"Detén esa ejecución."	nrv run-track stop <run>
"Cambia el titular de lo que entregaste."	nrv revise <project> "<change>"
"Muéstrame qué hizo esa ejecución."	nrv audit-view <project>
"Instala las dependencias de todos mis squads."	nrv activate --all
"Actualiza Nirvana-OS."	nrv update
"Actualiza mi pack Genesis Circle."	nrv update genesis-circle
"Pon Nirvana en modo economía."	nrv config set execution.profile economy --global

Los pedidos más grandes funcionan igual:

Usa Nirvana-OS para crear una empresa llamada podcast-empire que produzca, publique
y monetice 3 podcasts a la vez. Cada programa tiene su propio nicho, un presentador
de IA, un calendario editorial y un embudo de monetización independiente. Unos 7 empleados.

Usa Nirvana-OS para convertir la obra pública de <author> en un mind-clone de IA completo.

Usa Nirvana-OS para producir un paquete de lanzamiento: investigación de mercado,
copy de landing page y un análisis competitivo a fondo.

El agente orquesta y nunca escribe el entregable por sí mismo. Cada empresa que elige recibe su propio brief y su propia ejecución, en paralelo cuando las partes son independientes.

Packs

Los packs son empresas, squads y mind-clones curados que se venden en squads.sh. El buque insignia es Genesis Circle.

1. Compra el pack en squads.sh y descarga su zip desde tu panel.

2. Descomprime el archivo completo y abre una terminal en la carpeta que contiene setup.sh:

   • macOS: haz doble clic en el zip, escribe cd en Terminal, arrastra la carpeta a la ventana y pulsa Enter;
   • Windows: haz clic derecho en el zip, elige Extraer todo, abre la carpeta, haz clic derecho en un espacio vacío y elige Abrir en Terminal;
   • Linux y WSL: cd ~/Downloads && unzip <archivo>.zip -d <carpeta> && cd <carpeta>. En WSL, copia antes el zip de /mnt/c/Users/<usuario>/Downloads a ~/Downloads.

3. Ejecuta el setup:

   • macOS, Linux y WSL: bash setup.sh
   • Windows: powershell -ExecutionPolicy Bypass -File setup.ps1

   El setup instala Bun si hace falta, instala o actualiza el motor, copia el contenido en ~/squads, ~/businesses y ~/businesses/_library/dna, reconstruye los índices y guarda la licencia del pack en ~/.nirvana-license/packs/<pack>/. Nunca reemplaza el motor por una release más antigua, así que una beta sigue siendo beta.

4. Habla con tu agente: "Usa Nirvana para listar lo que me dio el pack Genesis Circle", y luego pide trabajo nombrando una empresa, un squad o el pack.

Activar los squads. Las dependencias de un squad se instalan bajo demanda la primera vez que se ejecuta, en su propio entorno en ~/.nirvana/envs/<squad>. Para prepararlas todas de antemano, pídele a tu agente: "Activa todos mis squads de Nirvana." Ejecuta nrv activate --all, que cubre paquetes de Node y Python, programas del sistema, claves de API y variables de entorno, servidores MCP y modelos. El agente recibe la lista de fallos con el comando exacto que corrige cada uno, y te pide permiso antes de cualquier cosa que use brew, sudo o winget, y para cualquier clave de API. La primera ejecución en un pack grande tarda varios minutos.

Actualizar un pack. Pídele a tu agente que lo actualice, o ejecuta nrv update <slug-del-pack>, por ejemplo nrv update genesis-circle. Los componentes que editaste se respaldan en ~/.nirvana/backups/packs/<pack>/ antes de que la actualización los reemplace. Si la actualización falla con un error de licencia, descarga el pack otra vez desde squads.sh y vuelve a ejecutar su setup; eso también renueva la licencia.

Actualizar el motor

Pídele a tu agente que actualice Nirvana-OS, o ejecuta nrv update. Primero hace una copia de ~/.nirvana/skills y conserva tu configuración y tu contenido. nrv update --check dice qué release instalaría sin cambiar nada.

Una actualización nunca lleva el motor a una release más antigua. Un motor estable solo pasa a una estable más nueva, así que un motor 0.14 pasa a la 0.15.1. Una beta pasa a la release mayor más nueva, beta o estable, así que una beta se convierte en la estable que sale después de ella. Después de actualizar el motor, nrv update también revisa cada pack instalado que tiene licencia y avisa cuando hay una versión nueva.

Betas

Las betas son prereleases en GitHub, y el comando del principio nunca instala una. Una beta se instala fijando su tarball: cambia v<version> abajo por su etiqueta de la lista de releases. La etiqueta empieza con v; sin ella la descarga devuelve 404.

macOS, Linux y WSL:

curl -fsSL https://gutomec.github.io/nirvana-os-engine/install.sh | NIRVANA_ENGINE_URL=https://github.com/gutomec/nirvana-os-engine/releases/download/v<version>/nirvana-os-engine.tar.gz bash

Windows (PowerShell), en una sola línea:

$env:NIRVANA_ENGINE_URL='https://github.com/gutomec/nirvana-os-engine/releases/download/v<version>/nirvana-os-engine.tar.gz'; irm https://gutomec.github.io/nirvana-os-engine/install.ps1 | iex

Después, si la ventana sigue abierta, ejecuta Remove-Item Env:NIRVANA_ENGINE_URL: mientras la variable exista, nrv update reinstala el tarball fijado. Los comandos de Windows usan comillas simples porque una comilla doble perdida al pegar deja a PowerShell esperando en >>.

Una vez en una beta, nrv update y cada setup de pack te mantienen en el canal beta: betas más nuevas y luego la estable que sale después.

Volver a la estable. En Windows, abre un PowerShell nuevo y ejecuta Remove-Item Env:NIRVANA_ENGINE_URL; un error que diga que no existe no es problema. Ejecuta el comando simple del principio de esta página. Instala la última estable sobre la beta y conserva tu contenido, los packs y la configuración. Comprueba que nrv --version ya no muestra beta y vuelve a ejecutar nrv init . en cada proyecto que usaste con la beta (detalles).

Configuración

La configuración cambia cuando lo pides. Basta con "pon Nirvana en modo economía", "calidad máxima" o "¿qué está configurado?"; tu agente ejecuta nrv config y te dice qué cambió.

Un perfil mueve varios ajustes a la vez:

Perfil	Esfuerzo	Techo de contexto por worker	Revisión	Verificaciones visuales de los workers
max	xhigh	ninguno (predeterminado del runtime)	cada entrega, hasta dos rondas	activadas
balanced	high	400k tokens	cuando una regla lo pide	desactivadas
economy	medium	200k tokens	solo a pedido	desactivadas

Un perfil nunca elige el modelo; eso lo hace la configuración propia de tu runtime. Un ajuste que cambias de forma explícita prevalece sobre el perfil. nrv config list muestra cada ajuste, su valor y de dónde viene. La referencia completa está en docs/configuration.md. Los perfiles existen solo a partir de 0.15.

Por proyecto. El orquestador escribe cada brief con una plantilla de brief. El engine trae cuatro: slim (la predeterminada: líneas cortas con etiqueta, las palabras del usuario guardadas en un archivo), standard (las seis secciones), detailed (las seis, más la estructura sugerida, el método y un criterio por ítem) y karpathy, inspirada en el post de Andrej Karpathy en X y en su 2025 Year in Review: la slim más un resumen en lenguaje sencillo, un diagrama y, cuando ayuda, una página HTML explicativa, con más tokens por entrega. nrv config set briefing.template detailed --project elige una para el proyecto, y nrv brief templates las lista. Para cambiar una o crear la tuya, por ejemplo juridico, ejecuta nrv brief init juridico --from standard --project: la copia en .nirvana/brief-templates/ gana sobre la de ~/.nirvana/brief-templates/ y sobre la del engine. briefing.altitude sigue funcionando como alias obsoleto. Las reglas en texto libre van en el CLAUDE.md, AGENTS.md o GEMINI.md del proyecto, encima del bloque de Nirvana que nrv init reescribe; tu agente las lee y las lleva a los briefs que escribe. Basta con pedirlo: "en este proyecto, usa briefs detallados", "añade al CLAUDE.md de este proyecto: todo entregable en portugués de Brasil".

Por qué "el trabajo está hecho" significa algo aquí

Un orquestador puede anunciar cualquier cosa en su mensaje final. Nirvana-OS respalda cada entrega con cosas que puedes abrir en el disco.

• Rastro de auditoría. Cada despacho, veredicto del gate y entrega es un evento append-only en ~/.harness-logs/<date>/audit.jsonl. Cada ejecución con --exec también deja un registro en el .nirvana/run-kernel.sqlite del proyecto. nrv audit-view <project> muestra la cadena.
• Verificado en el disco. verify-deliverable compara lo que el brief prometió con los archivos que existen, y el quality gate ejecuta rúbricas por tipo de archivo, con rondas de corrección cuando falla. Una ejecución cuyos fallos graves sobreviven a las correcciones se retiene, no se entrega.
• Briefs con criterios. Cada brief lleva el pedido del usuario al pie de la letra y criterios observables de "hecho cuando"; los marcados (blocking) deciden si la entrega pasa.
• Gasto bajo tu control. No se fija ningún techo de costo a menos que pidas uno ("limita cada ejecución a US$ 5" fija budget.default_max_cost_usd).

Referencia de comandos

Para agentes y usuarios avanzados. nrv help lo lista todo; nrv <command> --help da las opciones de cada comando. Referencia completa: docs/CLI.md.

Comando	Qué hace
nrv doctor	Chequeo de salud: runtimes, hooks, enlaces de skills, dependencias, registros, licencias
nrv init <dir>	Convierte una carpeta en un proyecto Nirvana (--orchestrators=always, --scope=project|merge|global)
nrv list-businesses / list-squads / list-clones	Recorre los tres registros
nrv find "<need>" / nrv search "<topic>"	Candidatos ordenados para un pedido / búsqueda por palabra clave en las bibliotecas
nrv brief template|templates|check|decide|init	El brief que el orquestador escribe para una empresa, a partir de una plantilla de brief
nrv dispatch <business> --brief-file <file> --exec	Ejecuta una empresa sobre un brief; --squad <slug>[:<capability>], --agent-x o --auto nombran otros objetivos. Se niega sin --exec
nrv run-track status|stop <run>	Lee el estado de una ejecución, o la detiene limpiamente
nrv revise <project> "<change>"	Cambia una entrega en la misma sesión del runtime
nrv audit-view <project>	La cadena de auditoría de una ejecución
nrv activate <squad>|--all	Prepara de antemano el entorno de un squad en ~/.nirvana/envs/<squad>
nrv config list|get|set|unset|explain	Configuración, con --global o --project
nrv update [--check] / nrv update <pack>	Actualiza el motor / un pack
nrv validate <squad|business|clone> <slug> [--fix]	Puerta de admisión de una entidad
nrv glance	Cockpit web (--read-only para solo explorar)
nrv uninstall --engine	Elimina el motor y conserva tu contenido

FAQ

¿Necesito saber programar? No. Describes resultados en lenguaje simple; tu agente ejecuta Nirvana, y las empresas y squads escriben, revisan y entregan.

¿Reemplaza a mi agente? No. Funciona encima de él. El trabajo despachado corre en el runtime de tu sesión a menos que nombres otro: Claude Code, Codex, Antigravity, Pi, Kimi, Grok, Qwen Code u OpenCode.

¿Dónde vive mi trabajo? En tu máquina: el contenido en ~/businesses, ~/squads y ~/businesses/_library/dna, los entregables en el outputs/ de cada proyecto. No hay ninguna nube de Nirvana en el circuito.

¿Y si nada de mi biblioteca encaja? El pedido se ejecuta igual, en agent-x, el generalista. También puedes pedirle a tu agente que cree la empresa o el squad que falta.

¿Windows? Nativo, a través de Bun, sin necesidad de WSL. Si prefieres WSL, instala todo dentro de Ubuntu, tu agente incluido.

Solución de problemas

• PowerShell muestra >> y se queda esperando. Quedó una comilla abierta al pegar. Pulsa Ctrl+C o abre una ventana nueva y vuelve a pegar la línea única.
• macOS muestra "Saving session… [Processo concluído]" después de cerrar Terminal. Es Terminal cerrando el shell, no un error.
• La instalación devuelve 404. A la etiqueta le falta la v inicial, o esa release no existe.
• La actualización de un pack falla con un error de licencia. Descarga el pack otra vez desde squads.sh y ejecuta su setup.
• Cualquier otra cosa. nrv doctor revisa toda la instalación y nrv install --check revisa los hooks y el PATH. Más en INSTALL.md.

Licencia, autoría y estado

Autor: Luiz Gustavo Vieira Rodrigues (gutomec / Prospecteezy). Sin coautores.

Licencia: la Nirvana-OS Sustainable Use License (SUL) v1.0. El código fuente está publicado y es abiertamente legible, y el motor es gratis para usar. Es source-available, no una licencia open-source aprobada por la OSI, y ciertos usos comerciales requieren una licencia comercial aparte. Lee LICENSE antes de confiar en cualquier resumen, incluido este.

Estado: beta (0.x, actualmente 0.15.1). El motor funciona hoy y se instala en minutos. Espera que la superficie siga moviéndose hasta la 1.0.