{
  "markdown": "<p align=\"center\">\n  <img src=\"docs/images/nauro-wordmark-dark.svg\" alt=\"Nauro\" width=\"180\">\n</p>\n\n<p align=\"center\"><strong>What every agent should know</strong></p>\n\n<p align=\"center\">\n  <a href=\"https://pypi.org/project/nauro/\"><img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/nauro.svg\"></a>\n  <a href=\"https://github.com/Nauro-AI/nauro/actions/workflows/ci.yml\"><img alt=\"CI\" src=\"https://github.com/Nauro-AI/nauro/actions/workflows/ci.yml/badge.svg?branch=main\"></a>\n  <a href=\"LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/badge/license-Apache%202.0-blue.svg\"></a>\n</p>\n\nKeep your project's direction in human hands as agents do more of the work.\n\nBefore work, Nauro surfaces relevant parts of that record. Approved judgment and reported progress carry into later sessions and connected tools.\n\n**Status:** Stable (1.x). Semantic versioning covers the CLI, local stdio MCP contract, on-disk store format, and curated `nauro-core` import API. Cloud sync and hosted MCP are versioned separately.\n\n## See it in practice\n\nhttps://github.com/user-attachments/assets/f75ede99-db11-4460-bc09-801c86df1e19\n\n*A real Codex session, then a Claude session in Pareto, Nauro's development mock project.*\n\n## Install\n\n```bash\nuv tool install nauro\n```\n\nInstall `uv` with `curl -LsSf https://astral.sh/uv/install.sh | sh` on macOS or Linux, or use the [Windows instructions](https://docs.astral.sh/uv/getting-started/installation/). With Python 3.10 or newer, `pipx install nauro` also works.\n\n## Try the demo\n\nPennykeep, the bundled demo, needs no account or agent setup:\n\n```bash\nmkdir -p /tmp/nauro-demo && cd /tmp/nauro-demo\nnauro init --demo\nnauro check-decision \"Store dollar amounts as decimal numbers\"\n```\n\nThe top result is `D001`, **Amounts stored in integer cents, never floating point**. Its rationale explains why floating point makes money totals drift.\n\n## Use it on your repo\n\n```bash\ncd your-repo\nnauro adopt --with-skills --with-subagents\n```\n\nRestart, then seed the store with `/nauro-adopt` in Claude Code, `$nauro-adopt` in Codex, or `@nauro-adopt` in Cursor Agent chat.\n\nPlain adopt installs `nauro-adopt`. `--with-skills` adds `nauro-ship-task`, `nauro-context`, `nauro-loop`, and `nauro-interview`. `--with-subagents` adds four workflow agents for Claude Code, Cursor, and Codex. Cursor stores its native project agents under `.cursor/agents/`.\n\nCursor runs `nauro-ship-task` natively. `nauro-loop` Program Delivery stays on hold.\n\nOn a new machine, run `nauro setup cursor`, then restart Cursor. Commit `.nauro/config.json`, `.cursor/rules/nauro-*.mdc`, and `.cursor/agents/nauro-*.md`, not the gitignored, machine-local `.cursor/mcp.json`. Cursor Cloud Agents need separate MCP configuration at `cursor.com/agents`.\n\nRun `nauro status` to check MCP, skills, and workflow agents. Run `nauro doctor` to check the project store.\n\nNauro surfaces prior judgment for the agent to assess. Retrieval is advisory. New or revised judgment requires your explicit approval. Local use needs no account, and the record is plain Markdown on your machine. Cloud sync and remote MCP access are optional. Nauro sends no product analytics.\n\nNauro preserves an existing `AGENTS.md` unless you explicitly run `nauro sync`. A `# Manual` section survives replacement.\n\n## Desktop app (macOS)\n\nA free, read-only viewer for the project record: timeline, map, list, activity, and docs. First launch installs the CLI, connects your agents, and adopts or attaches a project.\n\nhttps://github.com/user-attachments/assets/e23d3d7f-2d5b-4ce4-be18-fcaff74e7973\n\n[Download for macOS (Apple silicon)](https://github.com/Nauro-AI/nauro-app-releases/releases/latest/download/Nauro-macOS-arm64.dmg), signed and notarized.\n\n## Fit\n\nIf a small repo plus a reliable AGENTS.md or CLAUDE.md keeps agents oriented, Nauro may be more than you need.\n\nNauro is intended for longer-lived work where context can decay across sessions, tools, repositories, machines, or repeated handoffs.\n\nRead the [documentation](https://nauro.ai/docs) for setup variants, concepts, command references, storage, and cloud access.\n\n## Development\n\n```bash\nuv sync --all-packages --all-extras\nuv run pytest packages/nauro-core/tests/ -x -q\nuv run pytest packages/nauro/tests/ -x -q\n```\n\nReport bugs and request features in [GitHub Issues](https://github.com/Nauro-AI/nauro/issues).\n\nApache 2.0. Named for Peter Naur's *Programming as Theory Building* (1985).\n",
  "bytes": 4421,
  "sha": "0f7db26e596e5877dbbbafc3e14bf368e01283f3e62480e414525480592db7a7",
  "repo_slug": "nauro-ai/nauro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_nauro_nauro_429be324/readme"
}