Nauro

Дайте агентам контекст, которого не хватает в коде.

Nauro сохраняет текущее состояние, открытые вопросы и одобренное человеком проектное суждение в одной записи, готовой для каждого подключенного агента.

Запись объединяет рамки проекта, состояние, открытые вопросы и обоснование принятых решений. Nauro выводит релевантную часть перед началом работы, затем переносит утверждённое суждение и зафиксированный прогресс в последующие сессии и подключённые инструменты.

Статус: стабильна (1.x). Семантическое версионирование охватывает CLI, локальный MCP контракт для stdio, формат хранения на диске и курируемый API импорта nauro-core. Облачная синхронизация и размещенный MCP версионируются отдельно.

See it in practice

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

A real Codex session, then a Claude session in Pareto, Nauro's development mock project.

Install

uv tool install nauro

Установите uv с помощью curl -LsSf https://astral.sh/uv/install.sh | sh на macOS или Linux, или воспользуйтесь инструкциями для Windows. С Python 3.10 и выше также работает pipx install nauro.

Try the demo

Pennykeep, встроенная демонстрация, не требует учетной записи или настройки агента:

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

Первый результат — D001, Суммы хранятся в целых центах, без десятичной плавающей точки. Его обоснование объясняет, почему использование чисел с плавающей точкой приводит к дрейфу итоговых сумм.

Use it on your repo

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

Перезапустите вашего агента, затем вызовите /nauro-adopt в Claude Code или $nauro-adopt в Codex. Навык считывает документацию проекта и код, запрашивает у вас отсутствие обоснования и заполняет запись проекта, не придумывая решений. Та же команда onboarding устанавливает запираемый nauro-ship-task workflow и его планировщик, исполнитель, рецензент и технический лидер агентов для обеих поверхностей.

Запустите nauro status, чтобы проверить MCP вместе с установленными навыками и агентами workflow. Запустите nauro doctor, чтобы проверить само хранилище проекта. Повторный запуск команды onboarding обновляет файлы workflow, принадлежащие Nauro, и сохраняет восстанавливаемые копии разных версий. Она никогда не мигрирует и не изменяет сторонние навыки.

Nauro предоставляет предыдущее суждение агенту для оценки. Получение информации носит консультативный характер и никогда не блокирует изменения. Новое или обновлённое суждение записывается только после вашего явного подтверждения. Локальное использование не требует учетной записи. Локальная запись — это простой Markdown, который вы владеете. Облачная синхронизация и удалённый доступ к MCP являются необязательными. Nauro не отправляет аналитики продукта.

Приём на работу, настройка и сопутствующая регенерация сохраняют неуправляемый файл AGENTS.md и предупреждают об этом. nauro sync — единственный явный путь перезаписи. Раздел # Manual остаётся после замены.

Desktop app (macOS)

Бесплатный, бесплатный просмотрщик записи проекта в режиме только для чтения: временная шкала, карта, список, активность, документы. При первом запуске настраивает CLI.

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

Скачать для macOS (Apple Silicon), подписано и проверено.

Fit

Если небольшой репозиторий и надёжный AGENTS.md или CLAUDE.md держат агентов в нужном направлении, Nauro может оказаться для вас излишним.

Nauro предназначен для длительной работы, где контекст может распадаться между сессиями, инструментами, репозиториями, машинами или повторными передачами.

Изучите документацию для вариантов настройки, концепций, справочников по командам, хранения и облачного доступа.

Development

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

Сообщайте об ошибках и запрашивайте новые функции на GitHub Issues.

Apache 2.0. Назван в честь Питера Наура за его работу Программирование как построение теории (1985).