Nauro

Sistema de decisão para software construído com IA

Mantenha a direção do seu projeto em mãos humanas enquanto os agentes fazem mais do trabalho.

O Nauro registra as decisões de projeto que você aprova, incluindo seus motivos e alternativas rejeitadas. Ele traz esses motivos para sessões futuras de agentes.

Status: Estável (1.x).

Veja na prática

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

Uma sessão do Codex, depois uma sessão do Claude no Pareto, o projeto mock de desenvolvimento do Nauro.

O Nauro é adequado?

O Nauro oferece suporte a trabalhos de maior duração entre sessões, ferramentas e transferências. Se um repositório pequeno mais um AGENTS.md ou CLAUDE.md confiável mantém os agentes orientados, o Nauro pode ser mais do que você precisa.

A recuperação é consultiva. Decisões novas ou revisadas exigem sua aprovação explícita. O uso local não precisa de conta; o registro é Markdown simples na sua máquina. A sincronização em nuvem é opcional. O Nauro não envia análises de produto.

Comece

Aplicativo de desktop (macOS)

O aplicativo gratuito instala a CLI, conecta agentes e configura um projeto. Seu visualizador somente leitura mostra o registro do projeto.

Baixar para macOS (Apple silicon), assinado e notarizado. Guia de configuração.

Assista ao tour do aplicativo de desktop

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

CLI

uv tool install nauro

Instale o uv ou use pipx install nauro com Python 3.10 ou mais recente.

Experimente a demonstração (opcional)

Pennykeep é o aplicativo fictício de orçamento incluído.

• Solicitação: Substitua o orçamento por envelopes por gráficos de gastos para simplificar a integração.
• Decisão anterior: No histórico fictício do testador, o rastreamento passivo não ajudou os usuários a controlar gastos. A equipe aceitou configuração extra para que os usuários atribuam renda antes de gastar.
• Plano possível: Simplifique a configuração de envelopes ou pergunte se devemos revisitar o modelo de orçamento.

Nenhuma conta ou configuração de agente necessária. No macOS ou 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"

Procure por Método de orçamento por envelopes nas decisões relacionadas. Isso recupera o raciocínio anterior; não executa um agente nem altera decisões. Guia do PowerShell e demonstração.

Use no seu repositório

Para configuração da CLI:

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

Pule este comando se o assistente de desktop já adotou seu repositório. Reinicie seu agente e execute /nauro-adopt no Claude Code, $nauro-adopt no Codex ou @nauro-adopt no Cursor. Revise o registro de projeto proposto.

Aprove uma decisão existente que você quer que sessões futuras lembrem. Inicie uma nova sessão e pergunte sobre uma tarefa em que isso importa. Verifique como o agente usa o motivo.

Execute nauro status para verificar a conexão. Veja fluxos de trabalho de agentes e detalhes de configuração.

O nauro-investigator incluído estuda logs do Claude e do Codex em busca de descobertas suportadas sobre o uso e o desenvolvimento do Nauro. Veja o guia do investigador para uma primeira execução limitada e um caderno de pesquisa que execuções posteriores podem retomar.

Um AGENTS.md existente é preservado, a menos que você execute nauro sync. Sua seção # Manual sobrevive à substituição.

Documentação

A documentação cobre comandos, armazenamento e acesso em nuvem. O versionamento semântico cobre a CLI, o contrato MCP stdio local, o formato de armazenamento e a API nauro-core selecionada. A sincronização em nuvem e o MCP hospedado são versionados separadamente.

Desenvolvimento

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

Relate bugs e solicite recursos em GitHub Issues.

Apache 2.0. Nomeado em homenagem a Programming as Theory Building (1985), de Peter Naur.