Decision system for AI coding agents. Surfaces what your project decided, and why, before changes.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Nauro, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
Decision system for software built with AI
Keep your project's direction in human hands as agents do more of the work.
Nauro records the project decisions you approve, including their reasons and rejected alternatives. It brings those reasons into later agent sessions.
Status: Stable (1.x).
See it in practice
https://github.com/user-attachments/assets/f75ede99-db11-4460-bc09-801c86df1e19
A Codex session, then a Claude session in Pareto, Nauro's development mock project.
Is Nauro a fit?
Nauro supports longer-lived work across sessions, tools, and handoffs. If a small repo plus a reliable AGENTS.md or CLAUDE.md keeps agents oriented, Nauro may be more than you need.
Retrieval is advisory. New or revised decisions require your explicit approval. Local use needs no account; the record is plain Markdown on your machine. Cloud sync is optional. Nauro sends no product analytics.
Get started
Desktop app (macOS)
The free app installs the CLI, connects agents, and sets up a project. Its read-only viewer shows the project record.
Download for macOS (Apple silicon), signed and notarized. Setup guide.
Watch the desktop app tour
https://github.com/user-attachments/assets/e23d3d7f-2d5b-4ce4-be18-fcaff74e7973
CLI
Install uv, or use pipx install nauro with Python 3.10 or newer.
Try the demo (optional)
Pennykeep is the bundled fictional budgeting app.
- Request: Replace envelope budgeting with spending charts to simplify onboarding.
- Prior decision: In the fictional tester history, passive tracking did not help users control spending. The team accepted extra setup so users assign income before spending.
- Possible plan: Simplify envelope setup, or ask whether to revisit the budgeting model.
No account or agent setup required. On macOS or Linux:
Look for Envelope budgeting method in the related decisions. This retrieves prior reasoning; it does not run an agent or change decisions. PowerShell and demo guide.
Use it on your repo
For CLI setup:
Skip this command if the desktop wizard already adopted your repository. Restart your agent, then run /nauro-adopt in Claude Code, $nauro-adopt in Codex, or @nauro-adopt in Cursor. Review the proposed project record.
Approve one existing decision you want future sessions to remember. Start a fresh session and ask about a task where it matters. Check how the agent uses the reason.
Run nauro status to check the connection. See agent workflows and setup details.
An existing AGENTS.md is preserved unless you run nauro sync. Its # Manual section survives replacement.
Documentation
Documentation covers commands, storage, and cloud access. Semantic versioning covers the CLI, local stdio MCP contract, store format, and curated nauro-core API. Cloud sync and hosted MCP are versioned separately.
Development
Report bugs and request features in GitHub Issues.
Apache 2.0. Named for Peter Naur's Programming as Theory Building (1985).
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
10
Stargazers on the source repository.
Last commit
20d ago
Most recent push to the default branch.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Nauro
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/nauro)HTML Embed
<a href="https://allmcps.com/mcp/nauro"><img src="https://allmcps.com/api/badge/nauro?style=directory" alt="Nauro on AllMCPs" /></a>Technical Specs & Signals
CategoryCoding Agents
5/5 checks healthy over the last 43d
36Quality signal: Fair · 36/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools11/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.