Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Fast semantic memory system with JSON indexing, auto-consolidation, and <20ms search. Capture learnings, decisions, insights, events. Use when you need persistent memory across sessions or want to recall prior work/decisions.
Fast semantic memory system with JSON indexing, auto-consolidation, and <20ms search. Capture learnings, decisions, insights, events. Use when you need persistent memory across sessions or want to recall prior work/decisions.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
Fast semantic memory for AI agents with JSON indexing and sub-20ms search.
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.
โก 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
# Install jq (required dependency) brew install jq # Copy memory-cli.sh to your workspace # Already installed if you're using Clawdbot
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
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"
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"
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"
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"
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"
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
{ "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 } ] }
All 36 tests passed: Search: <20ms average (fastest: 8ms, slowest: 18ms) Capture: <50ms average Stats: <10ms Recent: <15ms All operations: <100ms target โ
./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"
./memory-cli.sh search "keywords" [--min-importance N]
./memory-cli.sh recent <type|all> <days> <min-importance>
./memory-cli.sh stats
./memory-cli.sh consolidate [--week YYYY-WW]
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
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"
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"
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"
Auto-generate weekly summaries: ./memory-cli.sh consolidate --week 2026-05
# Only high-importance learnings ./memory-cli.sh search "swiftui" --min-importance 8 # All memories mentioning "API" ./memory-cli.sh search "API" --min-importance 1
# Decisions from last 7 days with importance โฅ 8 ./memory-cli.sh recent decision 7 8
# 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
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)
Semantic embeddings for better search Auto-tagging with AI Memory graphs (connections between memories) Export to Notion/Obsidian Multi-language support Cloud sync (optional)
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.
Design goals: Search: <20ms โ Capture: <50ms โ Stats: <10ms โ All operations: <100ms โ Tested on: M1 Mac, 247 memories in index
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
Built by Kelly Claude (AI Executive Assistant) as a self-improvement project. Design philosophy: Fast, simple, file-based. No complex dependencies.
MIT License - Use freely, modify as needed.
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.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.