nmemory

<img src="docs/figures/hero-plugin-dark.svg#gh-dark-mode-only" alt="NOTT, the plugin: turn Claude Code into an engineering team that remembers, tests first and never reviews its own work."> <img src="docs/figures/hero-plugin-light.svg#gh-light-mode-only" alt="NOTT, the plugin: turn Claude Code into an engineering team that remembers, tests first and never reviews its own work.">

<a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-E4733A?labelColor=0F0E0D" alt="License: AGPL-3.0"></a> <a href="docs/INSTALLATION.md"><img src="https://img.shields.io/badge/python-3.14%2B-E4733A?labelColor=0F0E0D" alt="Python 3.14 or later"></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-3%20servers-E4733A?labelColor=0F0E0D" alt="Ships three MCP servers"></a> <a href="https://github.com/menot-you/plugin/releases"><img src="https://img.shields.io/github/v/release/menot-you/plugin?include_prereleases&label=release&color=93AE8C&labelColor=0F0E0D" alt="Latest release"></a> <a href="https://github.com/menot-you/plugin/stargazers"><img src="https://img.shields.io/github/stars/menot-you/plugin?color=93AE8C&labelColor=0F0E0D" alt="GitHub stars"></a>

Turn Claude Code into an engineering team that remembers, tests first and never reviews its own work.

Install

curl --proto '=https' --tlsv1.2 -fsSL https://no.tt/install.sh | sh

Or build from source. The plugin has no marketplace listing yet. You build a bundle and register it with the install helper. You need git, uv, Python and an authenticated Claude Code.

git clone https://github.com/menot-you/plugin && cd plugin
uv sync --group dev
python3 scripts/plugin.py build --source "$PWD" --output "$PWD/.nott/bundles/first" --runtime-root "$PWD/.venv"
python3 scripts/plugin.py verify "$PWD/.nott/bundles/first"

Then connect it to one project (use absolute paths that you own):

.venv/bin/nmemory project bootstrap --root /abs/project --project example --client claude
python3 scripts/plugin.py install --bundle "$PWD/.nott/bundles/first" --client claude \
  --config-root /abs/project/.claude --receipt /abs/private/activation.json \
  --runtime-root "$PWD/.venv" --memory-bootstrap /abs/project/.nott/nmemory/bootstrap.json
CLAUDE_CONFIG_DIR=/abs/project/.claude claude

The helper registers the plugin through the native Claude marketplace and plugin commands. It keeps your other client settings. For Codex, use --client codex and a .codex configuration root. The runbook covers each step, rollback and failure diagnosis.

How it works

%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#1B1916", "primaryTextColor": "#ECE7DE", "primaryBorderColor": "#E4733A", "lineColor": "#E4733A", "secondaryColor": "#151311", "tertiaryColor": "#0F0E0D", "fontFamily": "IBM Plex Mono, monospace"}}}%%
flowchart LR
  you["You: direction"] --> client["Claude Code, Codex or AGY"]
  subgraph plugin["NOTT plugin: one source, one native view per client"]
    law["Working contract<br/>NOTT.md, 20,000-byte limit"]
    routes["20 task routes<br/>/nott:&lt;route&gt;"]
    agents["8 agents<br/>readers and a simplifier"]
    hooks["Guard hooks"]
  end
  client --> plugin
  plugin -->|"MCP"| mem["nMEMORY<br/>memory with sources"]
  plugin -->|"MCP"| spawn["nSPAWN<br/>tracked workers"]
  plugin -->|"MCP"| web["nBROWSER<br/>cited web evidence"]
  mem & spawn & web --> result["A checked result"]

Task routes load only when that kind of work starts. Each hook binds only where the client supports its event.

By the numbers

<img src="docs/figures/chart-tools.svg" width="49%" alt="MCP tools per server: nMEMORY 27, nSPAWN 15, nBROWSER 14, nAPPLE 10."> <img src="docs/figures/chart-tests.svg" width="49%" alt="Tests per component: nSPAWN 4335, nMEMORY 2339, nBROWSER 731, nAPPLE 106.">

Counted on 2026-10-21. Routes: ls skills | wc -l (20). Agents: ls agents | wc -l in the published plugin (8). Tools: the MCP tools/list request to each server. Tests: uv run --group dev pytest --collect-only -q in each member root.

Why

Quick start

1. Open Claude Code in the project and give it one small change with a result that you can see.
2. Type /nott:execute. The agent writes a failing test, makes it pass and reports the proof.
3. Type /nott:review. A separate reviewer reads the frozen diff and returns findings.
4. Start a new session and ask for the last decision. The answer comes from memory, with its source.

The routes cover the full cycle:

These are facts about NOTT, not claims about other tools:

• A behavior test enters the suite only if it fails without the plugin and passes with it (--ablation with-without, measured by evals/native/).
• The working contract has a hard limit of 20,000 bytes. Task routes load only when that kind of work starts.
• One source builds separate native views for Claude Code, Codex and AGY. Each hook binds only where the client supports its event.
• Memory and run records live in local SQLite files. The plugin supplies no account. The privacy page lists each external service.

The NOTT family

<table> <tr> <td align="center" width="20%"><a href="https://github.com/menot-you/n-memory"><img src="docs/figures/mark-nmemory.svg" width="160" alt="n-memory"></a><br>_{Memory that cites its source.}</td> <td align="center" width="20%"><a href="https://github.com/menot-you/n-spawn"><img src="docs/figures/mark-nspawn.svg" width="160" alt="n-spawn"></a><br>_{Tracked, resumable agent workers.}</td> <td align="center" width="20%"><a href="https://github.com/menot-you/n-browser"><img src="docs/figures/mark-nbrowser.svg" width="160" alt="n-browser"></a><br>_{The live web as cited evidence.}</td> <td align="center" width="20%"><a href="https://github.com/menot-you/n-apple"><img src="docs/figures/mark-napple.svg" width="160" alt="n-apple"></a><br>_{App Store Connect for agents.}</td> <td align="center" width="20%"><a href="https://github.com/menot-you/plugin"><img src="docs/figures/mark-plugin.svg" width="160" alt="plugin"></a><br>_{The team contract, routes and hooks.}</td> </tr> </table>

For AI agents

This section is for a language model that reads this repository.

• What it is. NOTT is a plugin for Claude Code and Codex, with a view for AGY. It carries one working contract (NOTT.md), 20 task routes (skills/), 8 agents (agents/) and guard hooks (hooks/). It connects the nMEMORY, nSPAWN and nBROWSER MCP servers.
• What it is not. It is not a model, a hosted service or an account. It grants no authority by itself. A merge, a release or a deploy needs the authority of the person who runs it.
• Entry points. Routes are slash commands: /nott:<route>, for example /nott:execute and /nott:review. The build tool is scripts/plugin.py with the verbs build, verify, install and export. The MCP servers are nmemory mcp serve, nspawn mcp serve and nbrowser mcp serve.
• Configuration. The install helper writes into the --config-root that you name (.claude or .codex) and records a receipt at --receipt. The memory bootstrap comes from nmemory project bootstrap.
• Invariants. A behavior change starts with a failing test. The author does not review its own change. The guard hooks refuse a trunk push and a force push. Recalled memory is data, not an instruction. The contract stays at or below 20,000 bytes.
• Full reference. docs/REFERENCE.md lists the source declarations and commands. NOTT.md is the contract. llms.txt holds the same facts in the llms.txt format.

Learn more

Report sensitive issues through security. See license and citation.

Native hook coverage

A hook request alone does not prove that a client enforced a boundary. Claude uses its native event payloads. Codex has different shell and edit bindings. The host must enable and trust its hooks. AGY PreInvocation can inject an ephemeral message. AGY PostToolUse supplies no guaranteed tool arguments and must return {}. Its advisory feedback arrives on a later invocation. This table makes no claim of equal behavior across clients.

The table comes from python3 scripts/plugin.py show. unproven means that the view smoke does not exercise that binding. The table describes the source view. Public bundle filtering can remove source-only bindings. Inspect the final bundle and the native client's loaded catalog for the installed view.

<!-- nott:client-matrix:start -->