Nauro

Nauro

Dê aos seus agentes o contexto que o código deixa de fora.

O Nauro mantém o estado atual, perguntas em aberto e o julgamento de projeto aprovado por humanos em um único registro, pronto para cada agente que você conectar.

O registro combina escopo do projeto, estado, perguntas em aberto e a justificativa por trás das decisões. O Nauro apresenta a fatia relevante antes do trabalho e, em seguida, carrega o julgamento aprovado e o progresso relatado para sessões posteriores e ferramentas conectadas.

Status: Estável (1.x). O versionamento semântico cobre a CLI, o contrato MCP stdio local, o formato de armazenamento em disco e a API de importação nauro-core curada. A sincronização em nuvem e o MCP hospedado são versionados separadamente.

Veja na prática

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

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

Instalação

uv tool install nauro

Instale o uv com curl -LsSf https://astral.sh/uv/install.sh | sh no macOS ou Linux, ou use as instruções para Windows. Com Python 3.10 ou mais recente, pipx install nauro também funciona.

Experimente a demo

Pennykeep, a demonstração incluída, não precisa de conta ou configuração de agente:

mkdir -p /tmp/nauro-demo && cd /tmp/nauro-demo
nauro init --demo
nauro check-decision "Store dollar amounts as decimal numbers"

O principal resultado é D001, Valores armazenados em centavos inteiros, nunca em ponto flutuante. Sua justificativa explica por que o ponto flutuante faz os totais de dinheiro divergirem.

Use no seu repositório

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

Reinicie seu agente e invoque /nauro-adopt no Claude Code ou $nauro-adopt no Codex. A skill lê a documentação e o código do projeto, pergunta sobre a justificativa ausente e inicializa o registro do projeto sem inventar decisões. O mesmo comando de integração também instala o fluxo de trabalho nauro-ship-task controlado e seus agentes de planejador, executor, revisor e líder técnico para ambas as superfícies.

Execute nauro status para verificar o MCP, além das skills instaladas e dos agentes de fluxo de trabalho. Execute nauro doctor para verificar o armazenamento do projeto em si. Reexecutar o comando de integração atualiza os arquivos de fluxo de trabalho de propriedade do Nauro e mantém backups recuperáveis de cópias divergentes. Ele nunca migra ou altera skills de terceiros.

O Nauro apresenta o julgamento anterior para o agente avaliar. A recuperação é consultiva e nunca bloqueia uma alteração. O julgamento novo ou revisado é gravado somente após sua aprovação explícita. O uso local não precisa de conta. O registro local é Markdown simples que você possui. A sincronização em nuvem e o acesso MCP remoto são opcionais. O Nauro não envia análises de produto.

A adoção, a configuração e a regeneração incidental preservam um AGENTS.md não gerenciado e emitem avisos. nauro sync é o único caminho explícito de sobrescrita. Uma seção # Manual sobrevive à substituição.

Aplicativo de desktop (macOS)

Um visualizador gratuito e somente leitura do registro do projeto: linha do tempo, mapa, lista, atividade, documentos. O primeiro lançamento configura a CLI.

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

Baixar para macOS (Apple silicon), assinado e notarizado.

Adequação

Se um repositório pequeno com um AGENTS.md ou CLAUDE.md confiável mantém os agentes orientados, o Nauro pode ser mais do que você precisa.

O Nauro é destinado a trabalhos de longa duração, onde o contexto pode se deteriorar entre sessões, ferramentas, repositórios, máquinas ou transferências repetidas.

Leia a documentação para variantes de configuração, conceitos, referências de comandos, armazenamento e acesso em nuvem.

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.