Nauro

Sistema de decisiones para software construido con IA

Mantén la dirección de tu proyecto en manos humanas mientras los agentes hacen más del trabajo.

Nauro registra las decisiones de proyecto que apruebas, incluyendo sus razones y alternativas rechazadas. Lleva esas razones a sesiones posteriores de agentes.

Estado: Estable (1.x).

Véalo en la práctica

https://github.com/user-attachments/assets/f75ede99-db11-4460-bc09-801c86df1e19

Una sesión de Codex, luego una sesión de Claude en Pareto, el proyecto mock de desarrollo de Nauro.

¿Es Nauro adecuado?

Nauro soporta trabajo de mayor duración entre sesiones, herramientas y traspasos. Si un repositorio pequeño más un AGENTS.md o CLAUDE.md confiable mantiene a los agentes orientados, Nauro puede ser más de lo que necesitas.

La recuperación es consultiva. Las decisiones nuevas o revisadas requieren tu aprobación explícita. El uso local no necesita cuenta; el registro es Markdown simple en tu máquina. La sincronización en la nube es opcional. Nauro no envía analíticas de producto.

Comenzar

Aplicación de escritorio (macOS)

La aplicación gratuita instala la CLI, conecta agentes y configura un proyecto. Su visor de solo lectura muestra el registro del proyecto.

Descargar para macOS (Apple silicon), firmada y notarizada. Guía de configuración.

Ver el recorrido de la aplicación de escritorio

https://github.com/user-attachments/assets/e23d3d7f-2d5b-4ce4-be18-fcaff74e7973

CLI

uv tool install nauro

Instalar uv, o usar pipx install nauro con Python 3.10 o más reciente.

Probar la demo (opcional)

Pennykeep es la aplicación ficticia de presupuestos incluida.

• Solicitud: Reemplazar el presupuesto por sobres con gráficos de gastos para simplificar la incorporación.
• Decisión previa: En el historial ficticio de pruebas, el seguimiento pasivo no ayudó a los usuarios a controlar el gasto. El equipo aceptó configuración adicional para que los usuarios asignen ingresos antes de gastar.
• Plan posible: Simplificar la configuración de sobres, o preguntar si se debe revisar el modelo de presupuesto.

No se requiere cuenta ni configuración de agente. En macOS o Linux:

mkdir -p /tmp/nauro-demo && cd /tmp/nauro-demo
nauro init --demo
nauro check-decision "Replace envelope budgeting with a passive spending tracker and charts"

Busque Método de presupuesto por sobres en las decisiones relacionadas. Esto recupera razonamientos previos; no ejecuta un agente ni cambia decisiones. Guía de PowerShell y demo.

Úsalo en tu repositorio

Para configuración de CLI:

cd your-repo
nauro adopt --with-skills --with-subagents

Omite este comando si el asistente de escritorio ya adoptó tu repositorio. Reinicia tu agente, luego ejecuta /nauro-adopt en Claude Code, $nauro-adopt en Codex, o @nauro-adopt en Cursor. Revisa el registro de proyecto propuesto.

Aprueba una decisión existente que quieras que las sesiones futuras recuerden. Inicia una sesión nueva y pregunta sobre una tarea donde importe. Comprueba cómo el agente usa la razón.

Ejecuta nauro status para verificar la conexión. Consulta flujos de trabajo de agentes y detalles de configuración.

El nauro-investigator incluido estudia los registros de Claude y Codex en busca de hallazgos compatibles sobre el uso y el desarrollo de Nauro. Consulta la guía del investigador para una primera ejecución acotada y un cuaderno de investigación que ejecuciones posteriores pueden retomar.

Un AGENTS.md existente se conserva a menos que ejecutes nauro sync. Su sección # Manual sobrevive al reemplazo.

Documentación

La documentación cubre comandos, almacenamiento y acceso en la nube. El versionado semántico cubre la CLI, el contrato MCP stdio local, el formato de almacenamiento y la API nauro-core curada. La sincronización en la nube y el MCP alojado se versionan por separado.

Desarrollo

uv sync --all-packages --all-extras
uv run pytest packages/nauro-core/tests/ -x -q
uv run pytest packages/nauro/tests/ -x -q

Reporta errores y solicita funciones en GitHub Issues.

Apache 2.0. Nombrado por Programming as Theory Building (1985) de Peter Naur.