Skip to content

Requirements

MVP Requirements

  • Store user-level memories under ~/.nuzo/memory/.
  • Support project-level memories under <project>/.nuzo/memory/.
  • Expose memory operations through MCP tools.
  • Provide a CLI for users to inspect and manage memory outside an agent.
  • Keep memory files out of Git by default.
  • Record metadata for every memory.
  • Support export/import using a documented text format.
  • Allow deletion by ID, scope, tag, or all memories.
  • Support full-text search without embeddings.
  • Include a migration mechanism for schema changes.

Memory Operations

  • Remember a fact, preference, decision, or note.
  • Recall relevant memories for a query.
  • List memories by scope, tag, agent, or project.
  • Update a memory.
  • Forget a memory.
  • Export memories.
  • Import memories.
  • Show an audit trail for memory changes.

Quality Requirements

  • Deterministic storage path resolution.
  • No telemetry by default.
  • No network access by default.
  • Clear dry-run mode for destructive actions.
  • Human-readable errors.
  • Tests for storage, search, import/export, and MCP contracts.

Future Requirements

  • Optional embedding-backed retrieval.
  • Optional encrypted storage.
  • Optional sync provider.
  • Browser or TUI memory manager.
  • Agent-specific policies.
  • Team-level memory stores.