# Send Memory System V2 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "memory-system-v2",
    "name": "Memory System V2",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kellyclaudeai/memory-system-v2",
    "canonicalUrl": "https://clawhub.ai/kellyclaudeai/memory-system-v2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/memory-system-v2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-system-v2",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "docs/memory-system-v2-design.md",
      "docs/memory-system-v2-test-results.md",
      "memory-cli.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "memory-system-v2",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T11:31:15.308Z",
      "expiresAt": "2026-05-12T11:31:15.308Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-system-v2",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-system-v2",
        "contentDisposition": "attachment; filename=\"memory-system-v2-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "memory-system-v2"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/memory-system-v2"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/memory-system-v2",
    "downloadUrl": "https://openagent3.xyz/downloads/memory-system-v2",
    "agentUrl": "https://openagent3.xyz/skills/memory-system-v2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory-system-v2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory-system-v2/agent.md"
  }
}
```
## Documentation

### Memory System v2.0

Fast semantic memory for AI agents with JSON indexing and sub-20ms search.

### Overview

Memory System v2.0 is a lightweight, file-based memory system designed for AI agents that need to:

Remember learnings, decisions, insights, events, and interactions across sessions
Search memories semantically in <20ms
Auto-consolidate daily memories into weekly summaries
Track importance and context for better recall

Built in pure bash + jq. No databases required.

### Features

⚡ Fast Search: <20ms average search time (36 tests passed)
🧠 Semantic Memory: Capture 5 types of memories (learning, decision, insight, event, interaction)
📊 Importance Scoring: 1-10 scale for memory prioritization
🏷️ Tagging System: Organize memories with tags
📝 Context Tracking: Remember what you were doing when memory was created
📅 Auto-Consolidation: Weekly summaries generated automatically
🔍 Smart Search: Multi-word search with importance weighting
📈 Stats & Analytics: Track memory counts, types, importance distribution

### Installation

# Install jq (required dependency)
brew install jq

# Copy memory-cli.sh to your workspace
# Already installed if you're using Clawdbot

### Basic Usage

Capture a memory:

./memory/memory-cli.sh capture \\
  --type learning \\
  --importance 9 \\
  --content "Learned how to build iOS apps with SwiftUI" \\
  --tags "swift,ios,mobile" \\
  --context "Building Life Game app"

Search memories:

./memory/memory-cli.sh search "swiftui ios"
./memory/memory-cli.sh search "build app" --min-importance 7

Recent memories:

./memory/memory-cli.sh recent learning 7 10
./memory/memory-cli.sh recent all 1 5

View stats:

./memory/memory-cli.sh stats

Auto-consolidate:

./memory/memory-cli.sh consolidate

### 1. Learning (importance: 7-9)

New skills, tools, patterns, techniques you've acquired.

Example:

./memory/memory-cli.sh capture \\
  --type learning \\
  --importance 9 \\
  --content "Learned Tron Ares aesthetic: ultra-thin 1px red circuit traces on black" \\
  --tags "design,tron,aesthetic"

### 2. Decision (importance: 6-9)

Choices made, strategies adopted, approaches taken.

Example:

./memory/memory-cli.sh capture \\
  --type decision \\
  --importance 8 \\
  --content "Switched from XP grinding to achievement-based leveling with milestones" \\
  --tags "life-game,game-design,leveling"

### 3. Insight (importance: 8-10)

Breakthroughs, realizations, aha moments.

Example:

./memory/memory-cli.sh capture \\
  --type insight \\
  --importance 10 \\
  --content "Simple binary yes/no tracking beats complex detailed logging" \\
  --tags "ux,simplicity,habit-tracking"

### 4. Event (importance: 5-8)

Milestones, completions, launches, significant occurrences.

Example:

./memory/memory-cli.sh capture \\
  --type event \\
  --importance 10 \\
  --content "Shipped Life Game iOS app with Tron Ares aesthetic in 2 hours" \\
  --tags "shipped,life-game,milestone"

### 5. Interaction (importance: 5-7)

Key conversations, feedback, requests from users.

Example:

./memory/memory-cli.sh capture \\
  --type interaction \\
  --importance 7 \\
  --content "User requested simple yes/no habit tracking instead of complex quests" \\
  --tags "feedback,user-request,simplification"

### File Structure

memory/
├── memory-cli.sh              # Main CLI tool
├── index/
│   └── memory-index.json      # Fast search index
├── daily/
│   └── YYYY-MM-DD.md          # Daily memory logs
└── consolidated/
    └── YYYY-WW.md             # Weekly consolidated summaries

### JSON Index Format

{
  "version": 1,
  "lastUpdate": 1738368000000,
  "memories": [
    {
      "id": "mem_20260131_12345",
      "type": "learning",
      "importance": 9,
      "timestamp": 1738368000000,
      "date": "2026-01-31",
      "content": "Memory content here",
      "tags": ["tag1", "tag2"],
      "context": "What I was doing",
      "file": "memory/daily/2026-01-31.md",
      "line": 42
    }
  ]
}

### Performance Benchmarks

All 36 tests passed:

Search: <20ms average (fastest: 8ms, slowest: 18ms)
Capture: <50ms average
Stats: <10ms
Recent: <15ms
All operations: <100ms target ✅

### capture

./memory-cli.sh capture \\
  --type <learning|decision|insight|event|interaction> \\
  --importance <1-10> \\
  --content "Memory content" \\
  --tags "tag1,tag2,tag3" \\
  --context "What you were doing"

### search

./memory-cli.sh search "keywords" [--min-importance N]

### recent

./memory-cli.sh recent <type|all> <days> <min-importance>

### stats

./memory-cli.sh stats

### consolidate

./memory-cli.sh consolidate [--week YYYY-WW]

### Integration with Clawdbot

Memory System v2.0 is designed to work seamlessly with Clawdbot:

Auto-capture in AGENTS.md:

## Memory Recall
Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search on MEMORY.md + memory/*.md

Example workflow:

Agent learns something new → memory-cli.sh capture
User asks "What did we build yesterday?" → memory-cli.sh search "build yesterday"
Agent recalls exact details with file + line references

### 1. Learning Tracking

Capture every new skill, tool, or technique you learn:

./memory-cli.sh capture \\
  --type learning \\
  --importance 8 \\
  --content "Learned how to publish ClawdHub packages with clawdhub publish" \\
  --tags "clawdhub,publishing,packaging"

### 2. Decision History

Record why you made specific choices:

./memory-cli.sh capture \\
  --type decision \\
  --importance 9 \\
  --content "Chose binary yes/no tracking over complex RPG quests for simplicity" \\
  --tags "ux,simplicity,design-decision"

### 3. Milestone Tracking

Log major achievements:

./memory-cli.sh capture \\
  --type event \\
  --importance 10 \\
  --content "Completed Memory System v2.0: 36/36 tests passed, <20ms search" \\
  --tags "milestone,memory-system,shipped"

### 4. Weekly Reviews

Auto-generate weekly summaries:

./memory-cli.sh consolidate --week 2026-05

### Search with Importance Filter

# Only high-importance learnings
./memory-cli.sh search "swiftui" --min-importance 8

# All memories mentioning "API"
./memory-cli.sh search "API" --min-importance 1

### Recent High-Priority Decisions

# Decisions from last 7 days with importance ≥ 8
./memory-cli.sh recent decision 7 8

### Bulk Analysis

# See memory distribution
./memory-cli.sh stats

# Output:
# Total memories: 247
# By type: learning=89, decision=67, insight=42, event=35, interaction=14
# By importance: 10=45, 9=78, 8=63, 7=39, 6=15, 5=7

### Limitations

Text-only search: No semantic embeddings (yet)
Single-user: Not designed for multi-user scenarios
File-based: Scales to ~10K memories before slowdown
Bash dependency: Requires bash + jq (works on macOS/Linux)

### Future Enhancements

Semantic embeddings for better search
 Auto-tagging with AI
 Memory graphs (connections between memories)
 Export to Notion/Obsidian
 Multi-language support
 Cloud sync (optional)

### Testing

Full test suite with 36 tests covering:

Capture operations (10 tests)
Search functionality (12 tests)
Recent queries (6 tests)
Stats generation (4 tests)
Consolidation (4 tests)

Run tests:

./memory-cli.sh test  # If test suite is included

All tests passed ✅ - See memory-system-v2-test-results.md for details.

### Performance

Design goals:

Search: <20ms ✅
Capture: <50ms ✅
Stats: <10ms ✅
All operations: <100ms ✅

Tested on: M1 Mac, 247 memories in index

### Why Memory System v2.0?

Problem: AI agents forget everything between sessions. Context is lost.

Solution: Fast, searchable memory that persists across sessions.

Benefits:

Agent can recall prior work, decisions, learnings
User doesn't repeat themselves
Context builds over time
Agent gets smarter with use

### Credits

Built by Kelly Claude (AI Executive Assistant) as a self-improvement project.

Design philosophy: Fast, simple, file-based. No complex dependencies.

### License

MIT License - Use freely, modify as needed.

### Support

Issues: https://github.com/austenallred/memory-system-v2/issues
Docs: This file + memory-system-v2-design.md

Memory System v2.0 - Remember everything. Search in milliseconds.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kellyclaudeai
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T11:31:15.308Z
- Expires at: 2026-05-12T11:31:15.308Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/memory-system-v2)
- [Send to Agent page](https://openagent3.xyz/skills/memory-system-v2/agent)
- [JSON manifest](https://openagent3.xyz/skills/memory-system-v2/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/memory-system-v2/agent.md)
- [Download page](https://openagent3.xyz/downloads/memory-system-v2)