Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

2.9 KB
Raw Blame

Memory Plugin Examples

Store and Recall Across Sessions

Example 1: Remember a Code Pattern

# Session 1
npx ruflo memory store \
  --key "pattern-concurrent-queue" \
  --value "Use a bounded queue with semaphore for concurrent task processing; limits parallelism safely" \
  --namespace patterns

# Session 2 (next day, different project)
npx ruflo memory search -q "concurrent queue safe processing"
# Returns: "Use a bounded queue with semaphore..."

Example 2: Persist Bug Fixes

# Session 1: Solved a race condition
npx ruflo memory store \
  --key "fix-race-async-cleanup" \
  --value "Race condition in cleanup: use AbortController to signal cleanup before task dispatch" \
  --namespace solutions \
  --tags "async,cleanup,race"

# Session 2: Hit similar bug
npx ruflo memory search -q "race condition async"
# Gets the fix immediately

Example 3: Agent with Memory Bridge

// In a Claude Code agent
async function researchAuthPatterns() {
  // Search cross-session memory
  const findings = await memory_search_unified({
    query: "OAuth2 PKCE refresh token security",
    limit: 5
  });
  
  // findings[0] might be from a session 3 weeks ago
  console.log(findings[0].value); // Cross-session knowledge!
}

CLI Workflow

# Store architectural decision
npx ruflo memory store \
  --key "arch-event-sourcing" \
  --value "Event sourcing for user actions; snapshots every 10 events for performance" \
  --namespace patterns

# List all stored patterns
npx ruflo memory list --namespace patterns

# Search by semantic meaning (HNSW, fast!)
npx ruflo memory search --query "event-driven architecture" --namespace patterns

# Retrieve by key
npx ruflo memory retrieve --key "arch-event-sourcing" --namespace patterns

# Delete old entry
npx ruflo memory delete --key "old-pattern" --namespace patterns

Memory Namespaces

Use the right namespace for your intent:

Namespace Use For Example
patterns Reusable code/design patterns Auth flows, caching strategies
solutions Bug fixes and workarounds Race condition fix, memory leak
feedback User corrections and notes "Test style should use beforeEach"
security Vulnerability patterns "SQL injection risk in ORM queries"
tasks Task context and outcomes "API refactor: migrated 8 endpoints"

Integration with Auto-Memory Bridge

Claude Code auto-saves session memories to ~/.claude/projects/*/memory/. Import them into AgentDB:

# Current project (MCP, from Claude Code)
memory_import_claude({})

# All projects
memory_import_claude({ allProjects: true })

# From a terminal, in a project that has the ruflo helpers
node .claude/helpers/auto-memory-hook.mjs import-all

Then search across them:

npx ruflo memory search -q "authentication patterns"
# Returns unified results from ALL projects + sessions