Documentation

Choose how you want to connect. Then learn how to use the project record and keep consequential choices under your control.

Get started

Connect with MCPUse Grok Bot, Claude AI, or another hosted tool. Start with the MCP URL and sign in. Install the CLIConnect Codex, Claude Code, or Cursor to a local repository, then verify your first tool call. Get the macOS appUse guided local setup on Apple silicon. The app is optional.

Guides

Connect your agent Wire Claude Code, Cursor, or Codex to a project over the local stdio MCP server, or reach it from the cloud. Nauro app The free macOS desktop app: a read-only viewer over the local store with list, map, timeline, activity, and docs views. Using Nauro A working session with the record wired in: how decisions get recorded, what to commit, and how the record travels. Agents and skills The bundled Claude Code and Codex workflow agents and skills, what each role does, and how to install them.

Concepts

Core concepts What a decision is, how approval and superseding work, and how check_decision returns advisory related history. How the store works The plain-text, local-first store on disk: markdown decision files, BM25 retrieval, and the privacy posture.

Reference

CLI reference Every nauro command and flag, from setup and sync to the read and write tools that mirror MCP. MCP reference Shared registry: 11 tools. Local stdio: 10, with inputs and returns. Data storage Where decisions live on disk: the ~/.nauro store layout, file formats, atomic writes, and snapshots. Plans and limits Free local use, the 5,000 hosted MCP calls per month allowance, and current single-owner limits.