Nexus/.claude/commands/automation/session-memory.md

Cross-Session Memory

Purpose

Maintain context and learnings across Claude Code sessions for continuous improvement.

Memory Features

1. Automatic State Persistence

At session end, automatically saves:

• Active agents and specializations
• Task history and patterns
• Performance metrics
• Neural network weights
• Knowledge base updates

2. Session Restoration

// Using MCP tools for memory operations
mcp__claude -
  flow__memory_usage({
    action: "retrieve",
    key: "session-state",
    namespace: "sessions",
  });

// Restore swarm state
mcp__claude -
  flow__context_restore({
    snapshotId: "sess-123",
  });

Fallback with npx:

npx claude-flow hook session-restore --session-id "sess-123"

3. Memory Types

Project Memory:

• File relationships
• Common edit patterns
• Testing approaches
• Build configurations

Agent Memory:

• Specialization levels
• Task success rates
• Optimization strategies
• Error patterns

Performance Memory:

• Bottleneck history
• Optimization results
• Token usage patterns
• Efficiency trends

4. Privacy & Control

// List memory contents
mcp__claude -
  flow__memory_usage({
    action: "list",
    namespace: "sessions",
  });

// Delete specific memory
mcp__claude -
  flow__memory_usage({
    action: "delete",
    key: "session-123",
    namespace: "sessions",
  });

// Backup memory
mcp__claude -
  flow__memory_backup({
    path: "./backups/memory-backup.json",
  });

Manual control:

# View stored memory
ls .claude-flow/memory/

# Disable memory
export CLAUDE_FLOW_MEMORY_PERSIST=false

Benefits

• 🧠 Contextual awareness
• 📈 Cumulative learning
• ⚡ Faster task completion
• 🎯 Personalized optimization