better-memory

name	better-memory
description	Semantic memory, intelligent compression, and context management for AI agents. Prevents context limit amnesia with real embeddings, priority-based compression, and identity persistence.
homepage	https://github.com/DVNTYDIGITAL/better-memory
metadata	{"clawdbot":{"emoji":"🧠","requires":{"bins":[],"npm":["@xenova/transformers","tiktoken","sql.js"]},"install":[{"id":"npm","kind":"npm","label":"Install Better Memory dependencies","command":"cd ~/.clawdbot/skills/better-memory && npm install"}]}}

Better Memory

Semantic memory, intelligent compression, and context management for AI agents.

What It Does

• Stores memories with real vector embeddings (local, no API calls)
• Semantic search via cosine similarity
• Auto-deduplicates on store (exact + semantic)
• Priority-based compression when approaching context limits
• Identity persistence across sessions
• Token-budget-aware memory retrieval
• Configurable context limits, thresholds, and summarizer

Quick Start

import { createContextGuardian } from 'context-guardian';

const cg = createContextGuardian({
  contextLimit: 128000,
  summarizer: async (text) => myLLM.summarize(text), // optional
});
await cg.initialize();

// Store (auto-deduplicates)
await cg.store('User prefers TypeScript', { priority: 9 });

// Search
const results = await cg.search('programming preferences');

// Get memories within token budget
const { memories, tokensUsed } = await cg.getRelevantContext('query', 4000);

// Compress conversation and store important parts
const { compressed } = await cg.summarizeAndStore(messages);