Init Specification¶

nuzo memory init prepares a local memory store.

Goals¶

Create required directories.
Create or migrate the SQLite database.
Write a minimal config file.
Add or verify Git ignore rules.
Print the active memory scope.
Avoid overwriting existing memory.

User-Level Init¶

Command:

nuzo memory init

Creates:

~/.nuzo/
├── config.json
└── memory/
    ├── memories.sqlite
    ├── exports/
    └── logs/

User-level config stores an absolute path so runtime resolution is deterministic.

Project-Level Init¶

Command:

nuzo memory init --project

The project scope is project:<path-hash>, derived from the canonical project path without storing that path in the scope identifier.

After project init, CLI commands run from that project root automatically read .nuzo/config.json and use its local store and default scope. Explicit --store and --scope options override runtime resolution.

Project config stores .nuzo/memory/memories.sqlite as a relative path so it does not leak a machine-specific project path and remains portable.

Creates:

<project>/.nuzo/
├── config.json
└── memory/
    └── memories.sqlite

Updates project .gitignore with:

.nuzo/memory/
.nuzo/**/*.sqlite
.nuzo/**/*.sqlite-*

Config Shape¶

{
  "version": 1,
  "default_scope": "user:default",
  "storage": {
    "driver": "sqlite",
    "path": "~/.nuzo/memory/memories.sqlite"
  },
  "recall": {
    "limit": 8,
    "include_global": true
  },
  "privacy": {
    "allow_network": false,
    "record_recall_events": false
  }
}

Idempotency¶

Running init multiple times should be safe.

Rules:

never delete an existing database;
never rotate or rewrite memory IDs;
apply missing migrations only;
append missing .gitignore rules without duplicating them;
report existing paths clearly.

Project init cannot be combined with a custom --store path. Choose either the project layout or an explicit custom store.

Output Contract¶

Successful output should include:

Nuzo initialized
Store: ~/.nuzo/memory/memories.sqlite
Scope: user:default
Network: disabled