Local CLI + MCP server: set your project's doctrine once, every connected AI agent inherits it.
Project description
Nauro
Set the doctrine once. Every agent inherits it.
Your project's doctrine — goals, decisions, rejected paths — is inherited by every connected agent. When an agent proposes an approach that conflicts with a past decision, Nauro catches the drift before it ships. Works with Claude, Perplexity, ChatGPT, Cursor, and any MCP client.
Install
pipx install nauro # or: pip install nauro
Requires Python 3.10+.
Quickstart
nauro init --demo
nauro setup claude-code # writes the MCP entry to ~/.claude/settings.json
Open Claude Code and ask:
"Check if we should add a WebSocket endpoint for live task updates"
The demo creates a sample project with 7 decisions, project state, and open questions. check_decision surfaces a conflict: the team already chose SSE over WebSocket because persistent connections weren't released during ECS rolling deploys. No account needed.
For real-project setup, cross-surface access, MCP tool reference, and architecture details, see the main project README.
Why Nauro?
Memory tools record what agents saw and said. Nauro captures what you decided and rejected, then checks every session against those decisions before they drift.
The check_decision → propose_decision → confirm_decision pipeline surfaces conflicts for you to confirm before they're written, across any connected surface. Decisions made in Claude Code surface in Perplexity. No platform vendor owns your context.
Pricing
Free: unlimited local usage, unlimited projects, 5,000 remote MCP calls/month. See nauro.ai/pricing for hosted tiers.
Apache 2.0 license. Part of the nauro-ai/nauro monorepo.
Named for Peter Naur, whose 1985 paper Programming as Theory Building argued the real program is the theory in the programmer's mind, not the code. Every fresh agent session is the equivalent of losing that programmer.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nauro-0.3.0.tar.gz.
File metadata
- Download URL: nauro-0.3.0.tar.gz
- Upload date:
- Size: 106.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4d518230f07b1aa49fc6eb8e23bdd541ebd76743d55446ec196343afaa49328d
|
|
| MD5 |
f85ba6acf3962a0917321a845f9bf652
|
|
| BLAKE2b-256 |
e769531e4d6a09fa7327ddf35d509a7473893ed92e53a65b802ccaf049ebd16b
|
Provenance
The following attestation bundles were made for nauro-0.3.0.tar.gz:
Publisher:
publish-nauro.yml on Nauro-AI/nauro
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nauro-0.3.0.tar.gz -
Subject digest:
4d518230f07b1aa49fc6eb8e23bdd541ebd76743d55446ec196343afaa49328d - Sigstore transparency entry: 1540307839
- Sigstore integration time:
-
Permalink:
Nauro-AI/nauro@c576283442d723a97f2fb09ab9271d0f84416eb5 -
Branch / Tag:
refs/tags/nauro-v0.3.0 - Owner: https://github.com/Nauro-AI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-nauro.yml@c576283442d723a97f2fb09ab9271d0f84416eb5 -
Trigger Event:
push
-
Statement type:
File details
Details for the file nauro-0.3.0-py3-none-any.whl.
File metadata
- Download URL: nauro-0.3.0-py3-none-any.whl
- Upload date:
- Size: 133.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
430d0e97918645d57b9d42c6b5934bf0414641096d5a4aaa1fe7b96da64a2680
|
|
| MD5 |
d92756cf880d161d225ff5e825f831f7
|
|
| BLAKE2b-256 |
0c9646f666232d99acd04f1cda56ad02675e08d5dfec62dda46df59447f3e547
|
Provenance
The following attestation bundles were made for nauro-0.3.0-py3-none-any.whl:
Publisher:
publish-nauro.yml on Nauro-AI/nauro
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nauro-0.3.0-py3-none-any.whl -
Subject digest:
430d0e97918645d57b9d42c6b5934bf0414641096d5a4aaa1fe7b96da64a2680 - Sigstore transparency entry: 1540307962
- Sigstore integration time:
-
Permalink:
Nauro-AI/nauro@c576283442d723a97f2fb09ab9271d0f84416eb5 -
Branch / Tag:
refs/tags/nauro-v0.3.0 - Owner: https://github.com/Nauro-AI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-nauro.yml@c576283442d723a97f2fb09ab9271d0f84416eb5 -
Trigger Event:
push
-
Statement type: