Triple Memory System

A comprehensive memory architecture combining three complementary systems for maximum context retention across sessions.

Architecture Overview

User Message
     ↓
[LanceDB auto-recall] → injects relevant conversation memories
     ↓
Agent responds (using all 3 systems)
     ↓
[LanceDB auto-capture] → stores preferences/decisions automatically
     ↓
[Git-Notes] → structured decisions with entity extraction
     ↓
[File updates] → persistent workspace docs

The Three Systems

1. LanceDB (Conversation Memory)

Auto-recall: Relevant memories injected before each response
Auto-capture: Preferences/decisions/facts stored automatically
Tools:
```
memory_recall
```
,
```
memory_store
```
,
```
memory_forget
```
Triggers: "remember", "prefer", "my X is", "I like/hate/want"

2. Git-Notes Memory (Structured, Local)

Branch-aware: Memories isolated per git branch
Entity extraction: Auto-extracts topics, names, concepts
Importance levels: critical, high, normal, low
No external API calls

3. File Search (Workspace)

Searches: MEMORY.md, memory/*.md, any workspace file
Script:
```
scripts/file-search.sh
```

Setup

Enable LanceDB Plugin

{
  "plugins": {
    "slots": { "memory": "memory-lancedb" },
    "entries": {
      "memory-lancedb": {
        "enabled": true,
        "config": {
          "embedding": { "apiKey": "${OPENAI_API_KEY}", "model": "text-embedding-3-small" },
          "autoRecall": true,
          "autoCapture": true
        }
      }
    }
  }
}

Enable Auto Memory Flush (Pre-Compaction)

Add to your Clawdbot config to automatically preserve context before compaction:

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard",
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 8000,
          "systemPrompt": "Session nearing compaction. Preserve context using triple memory system (git-notes, LanceDB, files).",
          "prompt": "Context is at ~80%. Write session summary to memory/YYYY-MM-DD.md, update MEMORY.md if needed, store key facts to git-notes. Reply NO_REPLY when done."
        }
      }
    }
  }
}

This triggers automatic memory dump when context reaches ~80%, before any information is lost to compaction.

Install Git-Notes Memory

clawdhub install git-notes-memory

Create File Search Script

Copy

scripts/file-search.sh

to your workspace.

Usage

Session Start (Always)

python3 skills/git-notes-memory/memory.py -p $WORKSPACE sync --start

Store Important Decisions

python3 skills/git-notes-memory/memory.py -p $WORKSPACE remember \
  '{"decision": "Use PostgreSQL", "reason": "Team expertise"}' \
  -t architecture,database -i h

Search Workspace Files

./scripts/file-search.sh "database config" 5

Conversation Memory (Automatic)

LanceDB handles this automatically. Manual tools:

```
memory_recall "query"
```
- search conversation memory
```
memory_store "text"
```
- manually store something
```
memory_forget
```
- delete memories (GDPR)

Importance Levels

Flag	Level	When to Use
`-i c`	Critical	"always remember", explicit preferences
`-i h`	High	Decisions, corrections, preferences
`-i n`	Normal	General information
`-i l`	Low	Temporary notes

When to Use Each System

System	Use For
LanceDB	Conversation context, auto-retrieval
Git-Notes	Structured decisions, searchable by entity/tag
File Search	Workspace docs, daily logs, MEMORY.md

File Structure

workspace/
├── MEMORY.md              # Long-term curated memory
├── memory/
│   ├── active-context.md  # Current session state
│   └── YYYY-MM-DD.md      # Daily logs
├── scripts/
│   └── file-search.sh     # Workspace search
└── skills/
    └── git-notes-memory/  # Structured memory

Silent Operation

Never announce memory operations to users. Just do it:

❌ "I'll remember this"
❌ "Saving to memory"
✅ (silently store and continue)

Triple Memory

AI Skill Market Insights

Be Part of the 0+ Developer Community

Triple Memory System

Architecture Overview

The Three Systems

1. LanceDB (Conversation Memory)

2. Git-Notes Memory (Structured, Local)

3. File Search (Workspace)

Setup

Enable LanceDB Plugin

Enable Auto Memory Flush (Pre-Compaction)

Install Git-Notes Memory

Create File Search Script

Usage

Session Start (Always)

Store Important Decisions

Search Workspace Files

Conversation Memory (Automatic)

Importance Levels

When to Use Each System

File Structure

Silent Operation

Quick Start

Manual Installation

TEAR & SHARE

Tags

Multi-Agent Patterns

Memory Systems Design

Context Degradation Detection

Context Optimization

Tool Design for Agents

Channels

Learn

Compare

Company