Memory Garden

Stop answering the same questions twice.

Memory Garden learns what works in your domain and brings validated knowledge to every conversation. Unlike simple memory tools, patterns here must prove themselves through repeated successful use (N-count convergence).

Community-validated. Local-first. You control what stays.

Why Memory Garden?

Problem	Solution
AI forgets what worked yesterday	Patterns persist and surface when relevant
No way to know if advice is reliable	N-count shows how many times a pattern proved useful
Memory silos per project	Federated curation lets you subscribe to trusted sources
Privacy concerns with cloud memory	Local-first: nothing leaves your machine unless you opt-in

Features

Feature	Default	Description
Search	ON	Augment queries with validated patterns
Extraction	OFF	Extract patterns from conversations (opt-in)
Validation	ON	Record when patterns help (increments N-count)
Sync	OFF	P2P pattern synchronization (opt-in)

How N-Count Works

N=1: Pattern recorded (observation)
N=2: Pattern confirmed (recurring)
N=3+: Pattern validated (reliable knowledge)

Higher N-count = more trustworthy. Patterns that keep helping rise to the top.

Quick Start

The skill automatically manages the Memory Garden daemon:

• Starts daemon if not running
• Uses port 18790 (or next available)
• Health checks at /health

# Verify installation
clawhub inspect memory-garden

# Check daemon status
curl http://127.0.0.1:18790/health

Configuration

Set via environment variables:

Variable	Default	Description
MG_DAEMON_URL	http://127.0.0.1:18790	Daemon URL (if external)
MG_EXTRACTION_ENABLED	false	Enable pattern extraction
MG_EXTRACTION_CONFIRM	true	Require human confirmation
MG_SYNC_ENABLED	false	Enable P2P sync
MG_SEARCH_LIMIT	8	Default search result limit

Platform Support

Platform	Status	Notes
macOS Apple Silicon	✅ Supported	arm64
macOS Intel	✅ Supported	amd64
Linux x86_64 (glibc)	✅ Supported	amd64, requires glibc 2.31+ (Ubuntu 20.04+, Debian 11+)
Linux ARM64	❌ Not supported	libSQL limitation - vote for ARM64 support
Windows	⚠️ WSL2 required	Native Windows not supported
Alpine/musl	❌ Not supported	Requires glibc (libSQL dependency)

Data Handling

Your patterns are your intellectual property. Local-first means your learning stays yours until you choose to share.

• Patterns stored locally in ~/.memory-garden/
• No data sent externally unless sync explicitly enabled
• Extraction requires opt-in (MG_EXTRACTION_ENABLED=true)
• All operations logged to ~/.memory-garden/logs/

Security

• Daemon listens on localhost only (127.0.0.1)
• No outbound network by default
• Trust-gated tool access
• HMAC-SHA256 webhook verification (for CI integration)
• MIT License

Tools

Tool	Description	Default
search_patterns	Find validated patterns for your query	Enabled
plant_pattern	Record a new observation	Requires extraction
validate_pattern	Confirm a pattern helped (increments N-count)	Enabled
get_category_effectiveness	View fix success rates by category	Enabled

Integrations

Continuous AI Improver

Track which fix patterns actually get merged:

# Enable webhook endpoint
MG_WEBHOOK_ENABLED=true mg-daemon --serve

# Configure GitHub webhook to POST to /webhooks/github

See Continuous Improver Guide

Troubleshooting

Daemon won't start

1. Check if another instance is running: lsof -i :18790
2. Check logs: ~/.memory-garden/logs/daemon.log
3. Try manual start: mg-daemon --serve --addr 127.0.0.1:18790

Health check fails

1. Verify daemon is running: curl http://127.0.0.1:18790/health
2. Check port availability
3. Review daemon logs

Need help?

Open an issue: https://github.com/live-neon/memory-garden/issues

Learn More

• OpenClaw Quick Start
• P2P Sync Setup - Share patterns between machines
• Safe Defaults
• Architecture