Simple Memory

​

Requirements

• Node.js 22.12 or later

​

Install

pnpm add @obversa/memory-simple

​

Usage

import { createSimpleMemory } from '@obversa/memory-simple';

const memory = createSimpleMemory({
  scope: 'example-run',
});

await memory.execute({
  command: 'create',
  path: '/memories/notes.md',
  text: 'Keep the result small.\n',
});

const result = await memory.execute({
  command: 'view',
  path: '/memories/notes.md',
});

​

Commands

• create: Write a new file at a path.
• view: Read file content, with optional line range.
• str_replace: Replace unique text inside a file.
• insert: Insert text at a zero-based line index.
• delete: Remove a file from memory.
• rename: Move a file to a new path.

​

Limits

• Data is stored in memory and is discarded when the Node process exits.
• Default limits: 64 KB per file, 1 MB total memory per scope, and at most 256 files.
• Allowed file extensions: .txt, .md, .json, .py, .yaml, .yml.